JDBC批量插入异常处理：定位具体失败记录方法咨询

云上老周

2026-5-29

嘿，这个问题我之前帮不少开发者捋过思路，批量插入时定位失败记录确实是个头疼但关键的点，尤其是数据量上去之后。咱们一步步来拆解解决办法：

用executeBatch()直接定位失败记录

当你调用Statement.executeBatch()或者PreparedStatement.executeBatch()时，正常会返回一个int[]数组，数组里每个元素对应批量中每条语句的执行结果（成功的话是受影响行数或者Statement.SUCCESS_NO_INFO）。但如果某条语句失败，会直接抛出BatchUpdateException——这时候重点来了，这个异常自带的getUpdateCounts()方法能帮你定位问题。

举个实际代码例子，结合预先存储的SQL列表来定位：

List<String> sqlList = new ArrayList<>();
// 假设这里已经把1000条INSERT语句加载到sqlList里

try (Connection conn = getConnection()) {
    conn.setAutoCommit(false);
    Statement stmt = conn.createStatement();
    for (String sql : sqlList) {
        stmt.addBatch(sql);
    }
    
    int[] updateCounts = stmt.executeBatch();
    conn.commit();
} catch (BatchUpdateException e) {
    int[] successCounts = e.getUpdateCounts();
    // 数组长度就是成功执行的语句数量，失败的就是下一条（索引从0开始，所以要+1）
    int failedPosition = successCounts.length + 1;
    System.out.println("第 " + failedPosition + " 条语句执行失败");
    
    // 直接从列表里取出失败的SQL语句
    String failedSql = sqlList.get(successCounts.length);
    System.err.println("失败的SQL内容：" + failedSql);
    
    // 打印异常详情，看具体是约束冲突、数据类型错误还是其他问题
    e.printStackTrace();
}

这里要注意Oracle JDBC的默认行为：执行到失败语句就会停止，所以successCounts的长度就是成功执行的条数，失败的就是列表中索引为successCounts.length的那条。如果想让驱动继续执行剩下的语句（比如要一次性找出所有失败的记录），可以在JDBC URL里加oracle.jdbc.continueBatchOnError=true，这时候getUpdateCounts()返回的数组里，失败的位置会被标记为Statement.EXECUTE_FAILED，遍历数组就能找到所有失败的索引。

其他可行的处理方案

除了直接用executeBatch的返回值，还有几个更灵活的方案适合不同场景：

给每条SQL加前置日志：在把SQL加入批量之前，先打印每条语句的索引和内容到日志里，比如：
```
for (int i = 0; i < sqlList.size(); i++) {
    String sql = sqlList.get(i);
    logger.info("准备执行第 {} 条SQL：{}", i+1, sql);
    stmt.addBatch(sql);
}
```
批量失败后，看日志里最后一条成功执行的记录，下一条就是失败的，简单直接。
拆分大批次为小批次：不要一次性批量1000条，拆成比如50条或100条一批。这样即使某批失败，排查范围缩小到几十条里，再单独执行这批里的每条语句就能快速定位问题。这种方式还能避免大批次对数据库造成的性能压力。

用PreparedStatement绑定参数+参数日志：如果是用预编译语句绑定参数（比直接拼SQL更安全高效），可以把每个参数组和索引一起记录日志，失败时根据索引找到对应的参数组，再单独测试：

PreparedStatement pstmt = conn.prepareStatement("INSERT INTO user (id, name) VALUES (?, ?)");
List<Object[]> paramList = ...; // 存储每个记录的参数数组
for (int i = 0; i < paramList.size(); i++) {
    Object[] params = paramList.get(i);
    pstmt.setInt(1, (Integer)params[0]);
    pstmt.setString(2, (String)params[1]);
    logger.info("第 {} 条记录参数：id={}, name={}", i+1, params[0], params[1]);
    pstmt.addBatch();
}

数据库端日志辅助排查：如果是数据库层面的问题（比如唯一键冲突、字段长度超限），可以让DBA开启Oracle的SQL_TRACE或者查看AWR/ASH报告，直接捕获到执行失败的SQL语句，结合应用端日志定位具体记录。

内容的提问来源于stack exchange，提问作者user1126136