如何稳定识别Postgres中指定CONSTRAINT约束触发的异常

不要通过解析错误提示文本判断约束触发场景，这套方案完全不依赖服务端语言配置、不受Postgres版本迭代的消息文本变化影响，核心是使用JDBC标准结构化字段+驱动提供的约束元数据做判断：

核心判断依据（全版本/跨语言稳定） #

两个判断维度都是结构化返回的固定值，和错误提示文本无关：

• 唯一约束违反对应的SQL标准状态码固定为23505：这个编码是SQL标准明确定义的unique_violation错误码，PostgreSQL从早期版本到最新正式版从未修改过该返回值，和服务端locale配置完全无关。
• 触发的约束名是结构化返回的元数据：PostgreSQL JDBC驱动会直接把触发的约束名称作为独立字段返回，不需要从错误文本里拆分提取。

Jdbi下的具体实现 #

Jdbi本身是对JDBC的薄封装，你可以直接在异常捕获逻辑或者自定义的Jdbi异常处理器里遍历异常链，找到底层的PSQLException做判断即可，示例代码如下：

import org.postgresql.util.PSQLException;
import org.postgresql.util.ServerErrorMessage;
import org.jdbi.v3.core.JdbiException;

// 数据插入逻辑示例
public void insertReport(Long taskId, String foo) {
    try {
        jdbi.useHandle(handle -> handle
                .createUpdate("INSERT INTO report(task_id, foo) VALUES (:taskId, :foo)")
                .bind("taskId", taskId)
                .bind("foo", foo)
                .execute());
    } catch (JdbiException e) {
        Throwable current = e.getCause();
        while (current != null) {
            if (current instanceof PSQLException psqlEx) {
                // 第一步：过滤出唯一约束违反场景
                if ("23505".equals(psqlEx.getSQLState())) {
                    ServerErrorMessage errMsg = psqlEx.getServerErrorMessage();
                    // 第二步：匹配我们自定义的约束名
                    if (errMsg != null && "task_id_unique".equals(errMsg.getConstraint())) {
                        // 抛出和原有领域逻辑一致的自定义异常即可
                        throw new TaskIdDuplicatedException("当前task_id已存在，禁止重复创建", e);
                    }
                }
                break;
            }
            current = current.getCause();
        }
        // 其他异常正常抛出
        throw e;
    }
}

方案可靠性说明 #

• 全程不读取、不匹配错误提示的自然语言文本，服务端配置中文、英文或其他任意语言都不会影响判断结果
• 不需要依赖PostgreSQL的扩展函数或者额外系统表查询，判断逻辑完全在异常捕获环节完成，没有额外性能开销
• 只要你后续不手动修改DDL里的约束名task_id_unique，哪怕PostgreSQL大版本迭代调整了错误提示的措辞、格式，这套判断逻辑都能正常生效

注意：不要使用正则匹配错误文本（比如匹配"duplicate key"、"唯一约束冲突"这类关键词）的方案，这类方案在服务端切换语言、版本更新调整提示文案时会直接失效，没有稳定性保障。

内容的提问来源于stack exchange，提问作者oligofren