
在 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),可实现清晰的业务错误分层处理。
立即学习“Java免费学习笔记(深入)”;










