如何在PostgreSQL存储过程中定义自定义的异常提示信息?

阿伟小哥_9788

阿伟小哥_9788

2026-07-02

384人浏览

原创

raise exception必须显式指定5位sqlstate码(如'p0001')才能被java等客户端精准识别为业务异常;仅写raise exception 'msg'依赖默认码且不可靠,而exception块不能声明自定义异常名,只能用using errcode触发。

如何在postgresql存储过程中定义自定义的异常提示信息?

用 RAISE EXCEPTION 抛出自定义错误信息

PostgreSQL 不支持像 Oracle 那样先声明异常再 RAISE,而是直接用 RAISE EXCEPTION 语句构造带 SQLSTATE 的错误。SQLSTATE 是 5 位字符串,自定义时推荐用 P0001(PostgreSQL 官方保留的通用用户错误码),也可用 XX000 起头的未分配码。

  • RAISE EXCEPTION '用户输入无效:订单金额不能为负' USING ERRCODE = 'P0001';
  • 客户端收到的 SQLState 就是 P0001,便于 Java 等应用层精准识别
  • 避免只写 RAISE EXCEPTION 'xxx'——没指定 ERRCODE 时默认为 P0001,但显式写出更可靠
  • 不要用 RAISE NOTICE 或 RAISE WARNING 替代——它们不会中断执行,也无法被客户端捕获为异常

在 Java 中捕获并区分自定义错误

Java 的 SQLException 提供 getSQLState() 方法,必须靠它判断是否是你的业务异常,而不是靠 getMessage() 字符串匹配(易受翻译、格式变动影响)。

心流
心流

心流是一款AI工具,阿里旗下推出的AI搜索助手。

下载
  • 调用存储过程后,catch (SQLException e) 中检查 e.getSQLState().equals("P0001")
  • 若匹配,说明是主动抛出的业务校验失败,可转为 BusinessException 向上抛
  • 注意:PostgreSQL JDBC 驱动不会把 RAISE NOTICE 当作异常,所以 Java 侧收不到
  • 如果存储过程里用了 RAISE EXCEPTION ... USING ERRCODE = '23505'(唯一约束冲突),Java 收到的是标准 23505,不是你写的业务逻辑

为什么不能用 EXCEPTION 块“重抛”自定义错误

PL/pgSQL 的 EXCEPTION 块本质是错误处理分支,不是异常声明机制。你无法在 DECLARE 区定义一个叫 e_invalid_input 的异常变量,然后在 RAISE e_invalid_input ——这会报错 ERROR: unrecognized exception。

  • 所有自定义错误都必须用 RAISE EXCEPTION ... USING ERRCODE 直接触发
  • EXCEPTION 块里可以再次 RAISE,但只能复用原错误或构造新错误,不能引用未声明的“异常名”
  • 想统一错误码?直接在多个 RAISE EXCEPTION 处硬编码相同 ERRCODE,比如全用 'P0001'
  • 别试图模仿 Oracle 的 PRAGMA EXCEPTION_INIT——PostgreSQL 没这个语法

容易被忽略的细节:客户端是否真能看到错误

不是所有客户端都能完整接收 RAISE EXCEPTION 的全部字段。比如 psql 默认只显示 MESSAGE,而 DETAIL 和 HINT 需要 \set SHOW_CONTEXT always 才可见;Java 应用则只暴露 SQLState、errorCode 和 message。

  • 用 USING DETAIL = '原始参数值:'|| order_amount 补充上下文,对排查有帮助
  • 但别依赖 DETAIL 在所有客户端一致显示——Java 里它通常合并进 getMessage(),而 Web API(如 PostgREST)可能只映射 MESSAGE 到 HTTP body
  • 生产环境务必测试真实调用链:应用代码 → JDBC → PostgreSQL → 错误能否按预期被捕获和分类

相关文章

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

213

5

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

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

2023.11.02

4169

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

627

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

1376

6

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

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

2026.02.12

440

19

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

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

2026.05.08

130

10

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

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

2026.05.08

881

10

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

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

2026.05.08

224

10

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

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

2023.06.29

2325

3

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.3万人学习