如何在PostgreSQL存储过程中捕获并处理特定SQL错误码?

云涛小哥_2904

云涛小哥_2904

2026-07-15

832人浏览

原创

postgresql用when condition捕获特定sqlstate错误需通过预定义条件(如unique_violation→'23505')或直接匹配sqlstate五位码,后者支持自定义码如'45000';捕获后事务已标记aborted,须配合savepoint才能继续执行;行号等位置信息需在exception块中用get stacked diagnostics提取v_context等变量获取。

如何在postgresql存储过程中捕获并处理特定sql错误码?

怎么用 WHEN condition 捕获特定 SQLSTATE 错误

PostgreSQL 不支持像 SQL Server 那样用错误号(如 2627)直接匹配,它靠 SQLSTATE 五位码识别错误类型。预定义条件(如 unique_violation、foreign_key_violation)本质是 SQLSTATE 的别名,写起来更直观,但底层仍是匹配字符串。

常见预定义条件对应关系:

  • unique_violation → 23505(唯一约束冲突)
  • foreign_key_violation → 23503(外键约束违例)
  • not_null_violation → 23502(非空约束失败)
  • check_violation → 23514(检查约束不满足)
  • no_data_found → 02000(SELECT INTO 未返回行)

用法示例:

EXCEPTION
  WHEN unique_violation THEN
    RAISE NOTICE '用户名已存在,跳过插入';
    RETURN FALSE;
  WHEN foreign_key_violation THEN
    RAISE EXCEPTION '关联用户不存在,操作非法' USING ERRCODE = '45001';

为什么直接写 SQLSTATE 字符串比用预定义名更灵活

预定义名覆盖不了所有场景,比如自定义错误码 '45000' 或 PostgreSQL 扩展抛出的非标码(如 'XX000'),这时必须用 SQLSTATE 字面量匹配。

语法必须严格:WHEN 后跟 SQLSTATE 'XXXXX',单引号不能省,长度必须为 5。

示例:

EXCEPTION
  WHEN SQLSTATE '45000' THEN
    -- 处理业务校验失败
    INSERT INTO audit_log (msg) VALUES ('业务规则触发:' || username_var);
    RETURN NULL;
  WHEN SQLSTATE '23505' THEN
    -- 重复插入,但想走不同逻辑(比如更新 instead)
    PERFORM update_on_conflict(username_var, email_var);

注意:SQLSTATE '23505' 和 unique_violation 效果等价,但前者可读性差、易打错;后者推荐用于标准错误,前者留作兜底或扩展场景。

捕获后继续执行?小心事务状态被污染

PostgreSQL 的 EXCEPTION 块只“捕获”,不“恢复”事务状态。一旦错误发生,当前事务已标记为 aborted,后续任何 DML 都会报 current transaction is aborted。

PostgreSQL 18.4 ubuntu
PostgreSQL 18.4 ubuntu

PostgreSQL 18.4 官方 Ubuntu 安装包现已发布,这是目前最新的稳定版本。推荐通过官方 APT 仓库安装:先执行 sudo apt update 更新索引,再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统,在顺序扫描与 VACUUM 场景下性能提升显著,同时支持 UUID v7 原生生成函数与虚拟生成列。

下载

想在捕获后继续干活,必须提前设 SAVEPOINT:

  • 在 BEGIN 块开头写 SAVEPOINT sp1;
  • 在 EXCEPTION 块里写 ROLLBACK TO sp1;
  • 再执行你想干的语句(如日志写入、替代逻辑)

否则,哪怕你写了 INSERT INTO log_table,也会因事务已 abort 而失败。

典型结构:

BEGIN
  SAVEPOINT sp_main;
  INSERT INTO users (name) VALUES (username_var);
EXCEPTION
  WHEN unique_violation THEN
    ROLLBACK TO sp_main;
    INSERT INTO conflict_log (username, ts) VALUES (username_var, NOW());
    RETURN 'conflicted';
END;

怎么拿到错误发生的精确位置(行号、函数名)

PostgreSQL 没有 ERROR_LINE() 这种函数,但可用 GET STACKED DIAGNOSTICS 提取堆栈信息,包括出错行号、列号、函数名。

必须声明变量接收,且只能在 WHEN 分支内赋值:

DECLARE
  v_state TEXT;
  v_msg TEXT;
  v_detail TEXT;
  v_hint TEXT;
  v_context TEXT;
BEGIN
  ...
EXCEPTION
  WHEN OTHERS THEN
    GET STACKED DIAGNOSTICS
      v_state = RETURNED_SQLSTATE,
      v_msg = MESSAGE_TEXT,
      v_detail = PG_EXCEPTION_DETAIL,
      v_hint = PG_EXCEPTION_HINT,
      v_context = PG_EXCEPTION_CONTEXT;
    RAISE LOG 'Error at %: % (detail: %)', v_context, v_msg, v_detail;
END;

v_context 通常包含类似 PL/pgSQL function my_func() line 42 at SQL statement 的内容——这才是真实出错位置,不是函数入口行。

容易忽略的是:PG_EXCEPTION_CONTEXT 默认不启用,需确保 log_error_verbosity = verbose 或在会话级设置 client_min_messages = debug,否则为空。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
postgresql常用命令
postgresql常用命令

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、\l、\c、\dt、\d table_name、\du、\i file_name、\e和\q等。本专题为大家提供postgresql相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.10

233

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4489

19

postgresql常用命令有哪些
postgresql常用命令有哪些

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、\l、\c、\dt、\d table_name、\du、\i file_name、\e和\q等。更详细的postgresql常用命令,大家可以访问下面的文章。

2023.11.16

647

3

postgresql常用命令介绍
postgresql常用命令介绍

postgresql常用命令有\l、\d、\d5、\di、\ds、\dv、\df、\dn、\db、\dg、\dp、\c、\pset、show search_path、ALTER TABLE、INSERT INTO、UPDATE、DELETE FROM、SELECT等。想了解更多postgresql的相关内容,可以阅读本专题下面的文章。

2023.11.20

1396

6

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

2026.02.12

460

19

PostgreSQL 性能优化与查询执行计划实战
PostgreSQL 性能优化与查询执行计划实战

本专题深入解析PostgreSQL性能优化核心,聚焦查询执行计划的实战应用。通过EXPLAIN命令精准定位瓶颈,结合索引策略、SQL改写与参数调优,系统提升查询效率。从执行计划解读到性能调优全流程,助你掌握数据库性能诊断与优化实战能力。

2026.05.08

150

10

PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践
PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践

本文详解如何利用Next.js(搭配Drizzle ORM)与Go后端构建高性能应用,充分发挥PG在JSONB非结构化存储与pgvector向量检索上的优势。从数据建模到Docker容器化部署,打造支持AI时代的“One Database”工程化解决方案。

2026.05.08

901

10

PostgreSQL高级特性、内核机制与现代数据架构
PostgreSQL高级特性、内核机制与现代数据架构

本专题从MVCC并发控制与WAL日志等内核机制出发,详解JSONB、PostGIS及pgvector等高级特性。探讨如何利用单一引擎支撑关系型、向量及图数据等现代数据架构需求,助您掌握构建高并发、智能化应用的核心技术。

2026.05.08

244

10

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

2685

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 187人学习

PostgreSQL 教程
PostgreSQL 教程

共48课时 | 20.5万人学习

PostgreSQL 手册
PostgreSQL 手册

共0课时 | 1万人学习