在Java程序通过JDBC向表中插入数据时，如果表的主键被设置为自增类型，应用程序往往需要在插入完成后立即拿到这条记录对应的主键值，以便继续写入关联表或者返回给前端。JDBC规范中提供的getGeneratedKeys方法就是专门用于解决这一需求的，它可以在执行插入语句后，由数据库驱动把底层生成的自增列值返回给Java程序，而不需要再发起一次查询。
为什么需要getGeneratedKeys
在没有getGeneratedKeys之前，开发者通常会在执行插入之后，再调用类似select last_insert_id()这样的数据库专有语句去取最近一次插入生成的主键。这种做法在单线程或者简单脚本里问题不大，但在Web应用的多线程并发环境中，两次数据库交互之间完全可能被其他线程的插入操作打断，从而导致取到的并不是自己刚刚插入的那条记录的主键。
使用getGeneratedKeys可以从协议层面让数据库把插入生成的主键直接随更新结果一并返回，整个过程在一次PreparedStatement执行中完成，天然避免了并发取值错乱的问题。同时，它屏蔽了不同数据库在获取自增主键语法上的差异，使代码具备更好的可移植性。
PreparedStatement的正确配置
要使用该特性，核心点是在创建PreparedStatement时，通过重载的prepareStatement方法第二个参数明确告诉驱动：我需要返回哪些列，通常传入Statement.RETURN_GENERATED_KEYS常量，或者显式传入列名数组。如果省略这一步，即便执行了插入，调用getGeneratedKeys得到的结果集也可能是空的。
下面是一段标准的MySQL环境下使用RETURN_GENERATED_KEYS的示例，注意代码块内所有小于号、大于号都做了转义处理：
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.Statement;
public class InsertDemo {
public static void main(String[] args) throws Exception {
Connection conn = DriverManager_getConnection(); // 伪方法，实际从数据源获取连接
String sql = "insert into user(name, age) values(?, ?)";
// 声明需要返回自增主键
PreparedStatement ps = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS);
ps.setString(1, "张三");
ps.setInt(2, 28);
int affected = ps.executeUpdate();
System.out.println("影响行数: " + affected);
// 获取生成的主键结果集
ResultSet rs = ps.getGeneratedKeys();
if (rs.next()) {
// 第一列即为自增主键值
long id = rs.getLong(1);
System.out.println("生成的主键: " + id);
}
rs.close();
ps.close();
conn.close();
}
}
如果你的表结构里自增列并不叫id，或者你想明确指定返回的列，也可以把列名数组传进去，例如传入new String[]{"user_id"}。这种方式在部分数据库驱动上比使用常量更精确，也能避免驱动误返回其他内部生成列。
读取结果集的注意事项
getGeneratedKeys返回的是一个普通的ResultSet对象，只不过它里面的行和列对应的是生成列的值。绝大多数驱动会把自增主键放在结果集的第一列，因此用rs.getLong(1)或者按列名rs.getLong("id")都能取到。但要注意，并不是所有数据库都会填充列名元数据，所以依赖列名索引在某些驱动上会更稳妥。
另外，这个结果集必须在PreparedStatement或者连接关闭之前读取，一旦语句关闭，结果集也随之失效。很多初学者把getGeneratedKeys的结果集留到方法最后才处理，中间已经调用了ps.close()，这时就会抛出异常或者拿到空数据。
常见误区与对比
一个典型误区是直接使用Statement而非PreparedStatement，并且没有在创建时声明返回生成键。普通createStatement()创建的语句执行插入后，getGeneratedKeys只会返回空结果集。还有人以为只要SQL里写了自增列就能自动拿到，其实JDBC层面必须显式开启这个能力。
下面用表格对比两种常见做法的差异：
| 方式 | 是否额外查询 | 并发安全性 | 代码可移植性 |
|---|---|---|---|
| 插入后执行select last_insert_id() | 需要 | 低，可能被其他插入干扰 | 差，依赖数据库函数 |
| getGeneratedKeys配合预编译语句 | 不需要 | 高，一次执行内返回 | 好，符合JDBC规范 |
从表里可以清楚看到，使用getGeneratedKeys不仅在性能上少一次往返，也在正确性和跨数据库兼容上更有优势。
在事务与关联写入中的实践
实际业务中，经常是先插主表拿到主键，再插明细表。把这两步放在同一个事务里，配合getGeneratedKeys，就能保证数据一致性。示例代码如下：
Connection conn = DriverManager_getConnection();
conn.setAutoCommit(false);
try {
PreparedStatement ps1 = conn.prepareStatement(
"insert into orders(user_id, amount) values(?, ?)",
Statement.RETURN_GENERATED_KEYS);
ps1.setLong(1, 1001L);
ps1.setBigDecimal(2, new java.math.BigDecimal("99.50"));
ps1.executeUpdate();
ResultSet rs = ps1.getGeneratedKeys();
long orderId = 0;
if (rs.next()) {
orderId = rs.getLong(1);
}
rs.close();
ps1.close();
PreparedStatement ps2 = conn.prepareStatement(
"insert into order_item(order_id, product) values(?, ?)");
ps2.setLong(1, orderId);
ps2.setString(2, "键盘");
ps2.executeUpdate();
ps2.close();
conn.commit();
} catch (Exception e) {
conn.rollback();
throw e;
} finally {
conn.close();
}
这段代码中，orderId来自第一次插入的生成键，随后直接用于订单明细的order_id字段，整个过程在事务保护下完成。如果第二步失败，回滚后不会产生脏的主表记录，也不会出现主外键对不上的情况。
总体来看，getGeneratedKeys是JDBC里处理自增主键最规范、最安全的手段。只要记住在准备语句时声明返回生成列，并在语句关闭前读取结果集，就能稳定高效地拿到数据库分配的主键。
JDBCgetGeneratedKeys自增主键修改时间：2026-08-08 02:42:29