PostgreSQL错误信息查看咨询：新手遇语法错误无法获取详情

我是PostgreSQL新手，想获取更详细的错误信息。比如执行select top 10 * from TABLE时，只得到以下错误提示：

ERROR: syntax error at or near "10"
LINE 2: select top 10 * from TABLE
^
SQL state: 42601
Character: 13

我希望拿到更多错误详情，尝试了一段PL/pgSQL代码，但没成功（或者没掌握正确用法）：

DECLARE
  text_var1 text;
  text_var2 text;
  text_var3 text;
BEGIN
   SELECT TOP 10 * FROM tbl;  -- 明显错误的语法

EXCEPTION WHEN OTHERS THEN
  GET STACKED DIAGNOSTICS text_var1 = MESSAGE_TEXT,
                          text_var2 = PG_EXCEPTION_DETAIL,
                          text_var3 = PG_EXCEPTION_HINT;
END;

问题原因与解决方法 #

1. 先纠正核心语法错误 #

PostgreSQL不支持TOP语法，标准分页写法是用LIMIT：

SELECT * FROM TABLE LIMIT 10;

2. 为什么你的PL/pgSQL代码没拿到更多详情？ #

• 语法错误属于解析阶段错误，PL/pgSQL的EXCEPTION块只能捕获执行阶段的错误。解析错误会直接终止整个代码块，根本走不到EXCEPTION逻辑。
• 这类语法错误本身也没有额外的DETAIL或HINT信息，PostgreSQL给出的提示已经是最完整的：明确指出了错误位置、错误类型（SQL state 42601就是语法错误的标准代码）。

3. 正确捕获执行阶段错误的方法 #

如果是执行阶段的错误（比如表不存在、权限不足、数据类型不匹配等），可以用完整的匿名块或函数来捕获详情，并且必须输出变量的值才能看到结果：

DO $$
DECLARE
  text_var1 text;
  text_var2 text;
  text_var3 text;
BEGIN
   -- 故意构造一个执行阶段错误：查询不存在的表
   SELECT * FROM non_existent_table LIMIT 10;

EXCEPTION WHEN OTHERS THEN
  GET STACKED DIAGNOSTICS 
    text_var1 = MESSAGE_TEXT,
    text_var2 = PG_EXCEPTION_DETAIL,
    text_var3 = PG_EXCEPTION_HINT;
  -- 输出捕获到的错误信息
  RAISE NOTICE '错误消息: %', text_var1;
  RAISE NOTICE '错误详情: %', text_var2;
  RAISE NOTICE '错误提示: %', text_var3;
END $$;

执行后会得到类似这样的输出：

NOTICE: 错误消息: relation "non_existent_table" does not exist
NOTICE: 错误详情:
NOTICE: 错误提示: No relation named non_existent_table exists.

总结 #

• 语法错误无法通过PL/pgSQL的EXCEPTION捕获，因为解析阶段就失败了。
• 执行阶段的错误可以用带输出逻辑的匿名块/函数来获取详细诊断信息。
• 记住PostgreSQL的分页语法是LIMIT，而非TOP。

内容的提问来源于stack exchange，提问作者Araceli Fernández