如何在 Java 中捕获 PostgreSQL 存储过程中抛出的自定义错误

在 spring boot 应用中调用 postgresql 存储过程时，若过程内使用 `raise` 抛出自定义错误（如 `errcode='50000'`），需通过捕获 `sqlexception` 而非 `getwarnings()` 来准确识别和处理——因为 `raise ... using errcode` 触发的是**异常（error）而非警告（warning）**，`getwarnings()` 无法捕获。

PostgreSQL 中使用 RAISE ... USING ERRCODE = 'XXXXX'（如 '50000'）会向客户端发送一个 SQLSTATE 错误，JDBC 驱动会将其映射为 java.sql.SQLException，而非 SQLWarning。因此，正确做法是在 catch (SQLException e) 块中解析异常信息，重点检查 e.getSQLState() 和 e.getErrorCode()（PostgreSQL 特定）。

以下是推荐的健壮处理方式：

Connection conn = DatabaseConnection.connect();
CallableStatement stmt = null; // 推荐使用 CallableStatement 替代 PreparedStatement 调用存储过程

try {
    stmt = conn.prepareCall("{call public.my_sp(?,?,?,?,?,?)}");
    stmt.setInt(1, 123);        // 注意：原示例中 stmt.setInt(1, "") 会编译报错，应传 int 值
    stmt.setString(2, "val2");
    stmt.setString(3, "val3");
    stmt.setString(4, "val4");
    stmt.setString(5, "val5");
    stmt.setString(6, "val6");

    stmt.execute(); // 对于无返回结果的存储过程，使用 execute() 更规范
    return true;

} catch (SQLException e) {
    String sqlState = e.getSQLState();      // 获取 SQLSTATE，如 "50000"
    int errorCode = e.getErrorCode();       // PostgreSQL 返回的错误码（如 0 表示未映射，但可结合 SQLState 判断）
    String message = e.getMessage();

    // 精准识别自定义业务错误（例如拦截 '50000' 错误码）
    if ("50000".equals(sqlState)) {
        LOGGER.warn("业务校验失败：记录组合已存在 — {}", message);
        return false; // 或抛出自定义业务异常，如 throw new BusinessException("重复组合");
    } else {
        LOGGER.error("数据库执行异常（SQLState: {}, Code: {}）", sqlState, errorCode, e);
        throw e; // 非预期错误，向上抛出
    }
} finally {
    closeQuietly(stmt);
    closeQuietly(conn);
}

⚠️ 关键注意事项：

• ❌ getWarnings() 不适用：RAISE 永远生成 SQLException，不是 SQLWarning；getWarnings() 仅用于 NOTICE、WARNING 等非中断性消息（需显式启用 log_statement = 'all' 或 client_min_messages 配置，且 JDBC 不默认传递）。
• ✅ 使用 CallableStatement：比 PreparedStatement 语义更准确，支持 OUT/INOUT 参数及过程级错误传播。
• ✅ 检查 SQLState：PostgreSQL 将 USING ERRCODE = '50000' 映射为标准 SQLSTATE '50000'（类属“未分类用户错误”），这是跨驱动最稳定的识别依据。
• ✅ 避免 executeUpdate() 误用：对无结果集的存储过程，execute() 更合适；executeUpdate() 主要用于 INSERT/UPDATE/DELETE，其返回值语义不适用于过程调用。
• ✅ 资源安全关闭：建议封装 closeQuietly(Statement/Connection) 方法，避免 finally 中 SQLException 掩盖主异常。

总结：捕获 PostgreSQL 存储过程自定义错误的核心是 catch (SQLException) + e.getSQLState() 判定，而非依赖警告机制。结合 Spring Boot 的 @Transactional 和自定义异常处理器（如 @ControllerAdvice），可实现清晰的业务错误分层处理。