// PostgreSQL 错误参考

PostgreSQL P0001:raise exception

未指定自身 SQLSTATE 的 PL/pgSQL RAISE EXCEPTION。消息内容就是函数或触发器作者所写的文本。

SQLSTATE
P0001
名称
raise_exception
类别
PL/pgSQL 错误
错误信息
insufficient funds for account 42

它的意思

P0001 (raise_exception)是默认代码,用于 RAISE EXCEPTION 'message' 在 PL/pgSQL 中。这本身不是一个 PostgreSQL 错误:是你的数据库中的某个函数、过程或触发器选择失败,错误信息文本来自其代码。 CONTEXT 这些行显示了引发错误的函数和行号。

函数作者可以使用 USING ERRCODE,以及 DETAIL 和 HINT,这让应用更容易处理这个错误。

常见原因

  • 在触发器或函数中强制执行的业务规则,例如余额检查,拒绝了该更改。
  • 应用程序调用的验证函数因输入不正确而抛出错误。
  • 一个 ASSERT 失败时报的是另一个代码 P0004(assert_failure).

如何修复它

  1. 阅读 CONTEXT 行来定位函数和行号,再去看它的源代码。

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. 修正数据或调用以满足规则,如果规则有误则修改规则。

  3. 编写这类检查时,为它们指定有意义的代码和详细信息,调用方才能把它们区分开。

    RAISE EXCEPTION 'insufficient funds for account %', p_account
        USING ERRCODE = 'check_violation',
              DETAIL = format('balance %s, requested %s', v_balance, p_amount);

安全地复现它

DO $$ BEGIN RAISE EXCEPTION 'something went wrong'; END $$;  -- ERROR: something went wrong (SQLSTATE P0001)

相关错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。