Java中无法直接通过SQLException.getErrorCode()获取MySQL原生错误码（如1062），因其返回驱动定义的通用码；真实错误码藏于私有字段vendorCode，需反射提取，但存在兼容性风险，推荐优先使用SQLState结合映射表处理。
Java 中无法直接通过标准 JDBC 的 SQLException 获取 MySQL 原生错误码（如 1062 表示重复键），因为 SQLException.getErrorCode() 返回的是 JDBC 驱动定义的厂商无关码（MySQL Connector/J 通常返回 0 或通用值），而真正的 MySQL 错误码藏在驱动私有字段中。反射是可行的绕过方式，但需注意兼容性与稳定性。
确认目标字段：MySQL 驱动中的 error code 存储位置
以主流驱动 mysql-connector-java（8.x）为例，SQLException 实际由 com.mysql.cj.exceptions.SQLException（继承自 java.sql.SQLException）抛出，其内部通过 sqlState 和私有字段 vendorCode 携带 MySQL 原生错误码。该字段为 int 类型，但未暴露 public getter。
- 低版本（5.1.x）中对应类为
com.mysql.jdbc.SQLError封装逻辑，错误码常存于异常构造时传入的errorCode参数，但同样不对外公开 - 高版本（8.0+）中，
com.mysql.cj.exceptions.SQLException直接持有vendorCode字段（非 static，非 final） - 反射目标：获取实例字段
vendorCode的 int 值
用反射安全提取 vendorCode 字段值
需处理字段不可见、空指针、类型不匹配等异常，并避免硬编码类名导致跨版本断裂。建议结合 instanceof 判断 + 反射读取：
- 先检查异常是否为 MySQL 驱动抛出的具体类型（如
com.mysql.cj.exceptions.SQLException或其子类） - 使用
getClass().getDeclaredField("vendorCode")获取字段，调用setAccessible(true) - 捕获
NoSuchFieldException、IllegalAccessException等，失败时回退到getSQLState()解析或日志告警 - 避免对任意
SQLException盲目反射——只对已知 MySQL 驱动类型尝试
封装成可复用的工具方法
推荐将反射逻辑封装为静态工具，降低业务代码侵入性：
立即学习“Java免费学习笔记（深入）”；
public static int extractMySQLErrorCode(SQLException e) {
if (e == null) return -1;
Class<?> clazz = e.getClass();
// 兼容常见 MySQL 异常类名前缀
if (!clazz.getName().startsWith("com.mysql.cj.exceptions.")
&& !clazz.getName().startsWith("com.mysql.jdbc.")) {
return -1;
}
try {
Field field = clazz.getDeclaredField("vendorCode");
field.setAccessible(true);
Object value = field.get(e);
return value instanceof Integer ? (Integer) value : -1;
} catch (Exception ex) {
// 记录 warn 日志，不抛出：反射失败视为无 error code
return -1;
}
}调用处即可：int mysqlCode = extractMySQLErrorCode(e); if (mysqlCode == 1062) { /* 处理唯一键冲突 */ }
更健壮的替代方案：优先使用 SQLState + 自定义映射
反射虽可行，但依赖驱动实现细节，易随版本失效。生产环境建议组合策略：
- 利用
SQLException.getSQLState()（如"23000"表示完整性约束违规），它比 vendorCode 更稳定 - 对关键错误（如 1062、1205、1213）建立
SQLState → MySQL Code映射表，配合驱动文档校验 - 若必须用原生码，可在应用启动时探测当前驱动版本并缓存字段反射路径，减少运行时开销
- Spring JDBC 用户可考虑
SQLExceptionTranslator扩展，重写translate()提前解析 vendorCode
