Spring Boot JdbcTemplate中batchUpdate报ORA-00001，update正常问题排查

核心原因分析 #

1. 主键获取逻辑缺失（最可能） #

你提到通过createResource插入CarTable后要获取主键，但当前代码中该方法仅返回SQL执行的影响行数，并未实际获取插入生成的主键。如果CarTable的主键是Oracle序列自增生成的，你错误地将传入的carId参数当作新生成的主键传入createMultilpleRow，而这个carId对应的关联表记录已存在，就会触发ORA-00001唯一约束错误；单条插入时可能恰好使用了未重复的组合，因此未报错。

2. batchUpdate参数绑定不匹配 #

你的SQL占位符用的是小写:carId、:houseId，但参数键是大写CAR_ID、HOUSE_ID，JdbcTemplate的命名参数绑定是区分大小写的，可能导致参数绑定失败，所有batch记录的字段值重复（比如为null或默认值），触发唯一约束。

3. houseIds列表存在重复元素 #

如果传入的houseIds包含重复值，batchUpdate会一次性插入多条相同的(carId, houseId)组合，直接触发联合唯一约束；而单条插入时可能你做了隐式去重或仅测试了无重复的场景。

最佳修复方案 #

1. 正确获取自增主键 #

修改createResource方法，用KeyHolder获取Oracle序列生成的主键：

public Long createResource(String carName) { // 假设传入的是CarTable的非主键属性
    KeyHolder keyHolder = new GeneratedKeyHolder();
    jdbcTemplate.update(connection -> {
        // 假设CAR_ID由序列CAR_SEQ生成，或表设置了自增
        PreparedStatement ps = connection.prepareStatement(
            "INSERT INTO CarTable (car_name) VALUES (?)",
            new String[]{"CAR_ID"} // 指定主键列名，用于获取生成的主键
        );
        ps.setString(1, carName);
        return ps;
    }, keyHolder);
    return keyHolder.getKey().longValue();
}

如果carId是业务传入的非自增主键，需在插入前检查该carId是否已存在，避免重复插入CarTable。

2. 统一参数与占位符的大小写 #

将SQL占位符与参数键保持一致，比如统一为大写：

return jdbcTemplate.batchUpdate("""
        INSERT INTO CAR_HOUSE (CAR_ID, HOUSE_ID) -- 替换为实际表名，避免使用Oracle关键字TABLE
        VALUES (:CAR_ID, :HOUSE_ID)
        """, batch);

3. 对houseIds进行去重处理 #

在createMultilpleRow中先去重，避免插入重复的关联记录：

// 去重处理
List<String> distinctHouseIds = houseIds.stream().distinct().collect(Collectors.toList());

List<MapSqlParameterSource> sqlParameterSources = new ArrayList<>();
for (String houseId : distinctHouseIds) {
    MapSqlParameterSource sqlParameterSource = new MapSqlParameterSource();
    sqlParameterSource.addValue("CAR_ID", carId);
    sqlParameterSource.addValue("HOUSE_ID", houseId);
    sqlParameterSources.add(sqlParameterSource);
}

4. 验证关联表约束 #

确认关联表的唯一约束确实是(CAR_ID, HOUSE_ID)联合约束，排除其他约束（如单独的HOUSE_ID唯一）导致的错误。

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