Spring默认不暴露SQL状态码，但可通过ex.getCause()向下转型为SQLException后调用getSQLState()获取；也可自定义SQLExceptionTranslator或使用SQLExceptionSubclassTranslator保留该信息。
Spring 的 JdbcTemplate 或 DataSourceTransactionManager 在将 SQLException 转译为 DataAccessException（如 SQLStateException、DuplicateKeyException）时，默认会丢失原始的 SQL 状态码（SQL State），因为 Spring 的异常转译机制主要依赖 SQLException.getSQLState() 和厂商错误码做映射，但最终抛出的 DataAccessException 子类本身不暴露 sqlState 字段。
确保 sqlState 可被访问的关键方式
Spring 并未在标准 DataAccessException 层级提供 getSQLState() 方法，但你可以通过以下几种方式保留并获取原始 SQL 状态码：
-
从原始异常链中提取：所有 Spring 包装的
DataAccessException都保留了原始SQLException作为 cause。调用getCause()向下转型后即可获取：if (ex.getCause() instanceof SQLException) {<br> String sqlState = ((SQLException) ex.getCause()).getSQLState();<br>} -
自定义异常转译器：继承
SQLErrorCodeSQLExceptionTranslator或实现SQLExceptionTranslator，在创建DataAccessException时将其封装进自定义异常（如继承DataIntegrityViolationException并添加sqlState字段）。 -
使用
SQLExceptionSubclassTranslator（推荐用于现代 JDBC 驱动）：它基于 JDBC 4.0+ 的异常继承体系（如SQLTimeoutException、SQLNonTransientConnectionException），这些子类本身继承自SQLException，因此getCause()仍可安全转型并读取getSQLState()。
常见 SQL 状态码的业务用途
SQL 状态码（如 23505（PostgreSQL 唯一约束）、23000（SQL Server 主键冲突）、HY000（通用错误））比错误消息更稳定、更易解析。可用于：
Teleport tsh SSH (Identity-First SSH Access, no passwords/static keys)
下载
使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。
- 统一识别重复键、外键违规、超时、连接中断等场景，避免依赖易变的厂商错误消息文本
- 在全局异常处理器中根据
sqlState做精细化响应（如返回 409 Conflict 或 503 Service Unavailable） - 日志中结构化记录
sqlState，便于后续 ELK 或监控系统按状态码聚合分析
实际捕获与使用示例
在 service 层捕获异常时，建议这样处理：
立即学习“Java免费学习笔记（深入）”；
try {
jdbcTemplate.update("INSERT INTO users(name) VALUES (?)", "alice");
} catch (DataAccessException ex) {
Throwable rootCause = ex.getRootCause();
if (rootCause instanceof SQLException) {
String sqlState = ((SQLException) rootCause).getSQLState();
switch (sqlState) {
case "23505": // PostgreSQL unique_violation
throw new BusinessException("用户名已存在");
case "23000": // SQL Server general integrity violation
throw new BusinessException("数据完整性校验失败");
default:
throw ex;
}
} else {
throw ex;
}
}
注意事项
- 不要依赖
DataAccessException.getMessage()解析 SQL 状态——它可能被 Spring 重写或截断 - 某些数据库（如 H2）的
getSQLState()返回值可能不符合 SQL:2003 标准（例如返回HY000），需结合具体驱动文档验证 - 若使用 MyBatis，其
ExceptionTranslator默认也包装为RuntimeException，同样可通过getCause()获取原始SQLException
