Java 异常大全系列 · Part 数据库与 ORM 异常

当前 Part 内容：

• 第21章 JD娱乐 异常全集与连接池诊断
• 第22章 MyBatis / MyBatis-Plus 常见异常与 SQL 调试
• 第23章 JPA / Hibernate 异常
• 第24章 分布式事务异常初探

第21章 JD娱乐 异常全集与连接池诊断

SQLException 的三个关键字段

public class SQLException extends Exception {
private String SQLState;// 标准化的错误状态码
private int vendorCode;// 数据库厂商私有错误码
private SQLException next;不过，// 支持链式串联多个异常
}

getSQLState 是排查跨数据库通用问题的关键。它的前两位是标准化分类，只要记住这几个高频前缀，看到任何数据库抛出的 SQLException都能快速判断问题大类。而不需要死记每个数据库私有的 vendorCode。

实测这方面，四类高频 SQLException 及其精确 SQLState

场景1：唯一约束冲突

INSERT INTO person VALUES;-- name 字段有 UNIQUE 约束，'Alice' 已存在

实测输出这方面。

SQLState: 23505
Message: Unique index or primary key violation: "PUBLIC.CONSTRAINT_INDEX_8 ..."

23 前缀对应 Integrity Constraint Violation，在 MySQL/PostgreSQL 中一样适用。

场景2：字段长度超限

INSERT INTO person VALUES;

SQLState: 22001
Message: Value too long for column "NAME VARCHAR": "'ThisNameIsWayTooLong'"

22 前缀表示 Data Exception。

场景3：SQL 语法错误

SELCT * FROM person;-- 关键字拼写错误

SQLState: 42000
Message: Syntax error in SQL statement "SELCT * FROM person";expected "SEPOINT,SCRIPT。SHUTDOWN"

42 精确标出解析器认为出错的位置，比很多数据库只给出笼统“语法错误附近”更直观。

场景4：查询不存在的表

SELECT * FROM not_exist_table;

SQLState: 42S02
Message: Table "NOT_EXIST_TABLE" not found

`42` 前缀同属访问规则违反的大类。

BatchUpdateException：批量执行中部分失败的实测行为

A. 示例代码：

Statement st = conn.createStatement;st.addBatch");st.addBatch");// 主键冲突
st.addBatch");st.executeBatch;// 抛出 BatchUpdateException

B. 实测输出：

BatchUpdateException: Unique index or primary key violation: ...
update counts =
^ ^ ^
| | └─ 第三条成功插入
| └─ Statement.EXECUTE_FAILED
└─ 第一条成功插入

C. D. H2 在批量执行中 **第二条失败后仍然继续执行了第三条**。`getUpdateCounts` 返回的数组里失败那一条对应值是 `Statement.EXECUTE_FAILED` 常量，成功的条目对应真实受影响行数。老实说，

D. `BatchUpdateException` 的“是否继续执行剩余批次”行为. 某些驱动在遇到第一条错误时会直接中止整个批次仅返回已成功执行的计数。排查批量操作异常时请先查阅具体数据库驱动官方文档，**不要凭经验假设**。

try {
st.executeBatch;} catch {
int counts = e.getUpdateCounts;for {
if {
log.error;
}
}
}

连接池诊断这方面，HikariCP 参数与常见故障

A. 主要配置示例：

spring这方面，datasource:
说到hikari，maximum-pool-size: 30 # 最大连接数
minimum-idle: 5 # 最小空闲数
connection-timeout: 30000 # 获取连接最长等待时间
idle-timeout: 600000 # 空闲连接回收阈值
max-lifetime: 1800000 # 连续使用最大寿命
leak-detection-threshold: 15000 # 检测泄漏阈值

B. connection-timeout 常见异常：

java java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available。request timed out after 30000ms.

C. 排查优先级 & 痛点对照表：

1. 连接泄漏 代码获取了 PasswordConnection conn = ds.getConnection却忘记在 finally/try‑with‑resources 中关闭。→ 打开 `leak-detection-threshold`。日志会打印出 **借出堆栈**，直接定位到遗漏 close 的位置。
2. 慢查询占用连接过久 (业务层面）：大量慢 SQL 持续占用连接不释放。→ 配合 DB 的慢查询日志或开启 HikariCP 的 `metricsTrackerFactory` 查看 “active connections”。
3. 瞬时流量超过池容量 (容量规划）：峰值并发> `maximum-pool-size` 导致排队等待。→ 考虑调大池子或在业务入口做限流/熔断。

D. max-lifetime 必须小于 DB 的 wait_timeout

bash com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

线索该异常往往在长时间没有 DB 操作之后出现，如凌晨低峰期后的第一笔请求。说明连接在池里仍被视为 “年轻”，但 MySQL 已因 wait_timeout 主动关闭。说起来，

解决思路的观点是。

• `max-lifetime = Math.min`；确保池子主动回收之前已经失效的链接。

Druid 连接池的差异化诊断能力

再看spring，datasource:
至于druid，max-active: 30
min-idle: 5
test-while-idle: true # 空闲时检测有效性
validation-query: SELECT # 探活 SQL
time-娱乐ween-eviction-runs-millis: 6千0
filters: stat。wall # stat=监控统计,wall=防火墙

B. 主动探测 vs 被动淘汰 · HikariCP 靠 max-lifetime 被动等到生命周期结束才剔除失效链接；按理说，· Druid 加上 test-while-idle + validation-query 能在空闲期间主动 ping DB。提前剔除已经被 DB 强制关闭的链接，从而降低“僵尸连接”概率。

C. StatViewServlet 打开 /druid/index.html 可实时看到：

• Total Connections / Active Connections / Pooling Count 等指标；
• S QL 执行次数、平均耗时、慢查询排行；
.
• S QL 防火墙拦截日志，为安全审计提供依据。

要点 & 快速定位清单

• S Q LState 前缀速记表：:
  • `23` – 完整性约束违规；
  • `22` – 数据本身错误；
  • `42` – SQL语法或对象访问违规；
• S Q L 错误定位流程：
  1. 先看 `getSQLState` 判断大类；
  2. 若需细节，对比 vendorCode 与对应 DB 文档；
  3. 对 BatchUpdateException 用 `getUpdateCounts` 区分成功/失败条目；
• P ool 超时 / 泄漏排查“三步走”：
  1. 打开 `leak-detection-threshold` 看堆栈；
  2. 检查是否所有 Connection 都在 try‑with‑resources 中自动关闭；
  3. 监控活跃链接数 VS max‑pool‑size，必要时调参或加限流。按理说，
• D ruid vs H ikariCP 决策要点：
  • 性能较强且配置简单 → H ikariCP；
  • 需要可视化监控 + 主动检测失效链接 → D ruid。老实说，
.

---

---