使用ojdbc8执行Insert后获取自增ID报SQLException问题求助

我之前也碰到过一模一样的问题——ojdbc7下运行毫无问题的代码，切换到ojdbc8就突然抛出这个错误，折腾了好一阵才摸清楚根源。核心问题在于ojdbc8对JDBC获取自增键的API处理逻辑做了更严格的校验，尤其是针对Oracle数据库的场景。

问题根源 #

你原来使用的prepareStatement(sql, new String[]{"id"})方式，在ojdbc7中驱动会做兼容处理，但ojdbc8里的AutoKeyInfo类对传入的列名参数校验更严苛了。如果你的id列不是Oracle 12c+的IDENTITY列（而是用序列+触发器实现的自增），驱动会直接判定参数无效，抛出这个异常。

两种可行的解决方案 #

方案一：改用JDBC标准的RETURN_GENERATED_KEYS常量

这是最简单的修改方式，直接替换列名数组参数为JDBC定义的标准常量：

// 替换原prepareStatement初始化代码
PreparedStatement preparedStatement = connection.prepareStatement(query.toString(), Statement.RETURN_GENERATED_KEYS);

preparedStatement.executeUpdate();
// 用try-with-resources自动关闭ResultSet，避免资源泄漏
try (ResultSet resultSet = preparedStatement.getGeneratedKeys()) {
    if (resultSet.next()) {
        return resultSet.getLong(1);
    }
}
// 处理未获取到ID的异常情况
throw new SQLException("Failed to retrieve generated ID");

这种方式属于JDBC标准规范，ojdbc8对它的支持更稳定，不管你的自增是用IDENTITY列还是序列+触发器实现，基本都能正常工作。

方案二：使用Oracle原生的RETURNING INTO子句（更推荐）

如果你的项目是专门针对Oracle数据库的，这种原生方式兼容性最好，性能也更优：

1. 先修改Insert语句，添加RETURNING id INTO ?子句：
   比如原语句是：

   INSERT INTO fee (amount, create_time) VALUES (?, ?)
   

   修改后变为：

   INSERT INTO fee (amount, create_time) VALUES (?, ?) RETURNING id INTO ?
   

2. 调整Java代码，注册输出参数并直接获取生成的ID：

   PreparedStatement preparedStatement = connection.prepareStatement(query.toString());
   // 设置Insert的输入参数
   preparedStatement.setBigDecimal(1, feeAmount);
   preparedStatement.setTimestamp(2, new Timestamp(System.currentTimeMillis()));
   // 注册输出参数，对应RETURNING子句的位置
   preparedStatement.registerOutParameter(3, Types.BIGINT);
   
   preparedStatement.executeUpdate();
   // 直接从PreparedStatement获取生成的ID
   Long generatedId = preparedStatement.getLong(3);
   

这种方式是Oracle数据库原生支持的返回生成键的逻辑，完全绕开了JDBC驱动层对列名的校验，在ojdbc8中绝对不会出现参数无效的问题。

额外提醒 #

• 如果你的id列是用序列+触发器实现的自增，方案一的RETURN_GENERATED_KEYS需要ojdbc8驱动版本至少为12.2.0.1及以上，否则可能仍有问题，这时方案二更稳妥。
• 务必用try-with-resources管理ResultSet、PreparedStatement等资源，避免内存泄漏或连接池占用问题。

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