使用JDBC插入自增主键数据时，必须调用getGeneratedKeys()获取主键值；推荐用PreparedStatement配合Statement.RETURN_GENERATED_KEYS或显式列名数组，禁用SELECT MAX(id)等不安全方式。
在使用 JDBC 插入数据时，若表的主键是数据库自增（如 MySQL 的 AUTO_INCREMENT、PostgreSQL 的 SERIAL），需要显式告诉 JDBC 驱动“我要获取刚插入的主键值”，否则默认不会返回。核心方法是通过 Statement 或 PreparedStatement 的 getGeneratedKeys() 方法。
使用 PreparedStatement 获取自增主键（推荐）
这是最常用、最安全的方式，适用于大多数场景：
- 创建
PreparedStatement时，传入参数Statement.RETURN_GENERATED_KEYS； - 执行
executeUpdate()后，调用getGeneratedKeys()得到ResultSet； - 该
ResultSet默认只有一列（即主键列），类型为BIGINT或对应数据库类型，需用getLong(1)或getInt(1)读取。
示例（MySQL）：
String sql = "INSERT INTO user(name, email) VALUES(?, ?)";
try (PreparedStatement ps = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) {
ps.setString(1, "张三");
ps.setString(2, "zhangsan@example.com");
int affected = ps.executeUpdate();
if (affected > 0) {
try (ResultSet rs = ps.getGeneratedKeys()) {
if (rs.next()) {
long id = rs.getLong(1); // 获取第一个（也是唯一）生成的主键
System.out.println("插入成功，主键ID：" + id);
}
}
}
}
指定列名获取（更明确，兼容性更好）
某些数据库（如 PostgreSQL、SQL Server）对列名敏感，或表有多个自增字段时，建议显式指定主键列名：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 将
Statement.RETURN_GENERATED_KEYS替换为字符串数组，如new String[]{"id"}； - 这样可确保驱动返回指定列，避免因列序或别名导致读取错误；
- 尤其在多主键或复合键场景下，必须明确列名。
示例：
String[] keyColumns = {"id"};
try (PreparedStatement ps = conn.prepareStatement(sql, keyColumns)) {
ps.setString(1, "李四");
ps.executeUpdate();
try (ResultSet rs = ps.getGeneratedKeys()) {
if (rs.next()) {
long id = rs.getLong("id"); // 用列名读取，更清晰
}
}
}
注意不同数据库的差异
虽然 JDBC 规范统一，但各驱动实现略有不同：
-
MySQL Connector/J：支持
RETURN_GENERATED_KEYS和列名数组；若使用rewriteBatchedStatements=true批处理，getGeneratedKeys()可能只返回最后一个语句的键； -
PostgreSQL（PgJDBC）：必须指定列名（如
new String[]{"id"}），否则可能返回空结果； - H2 / HSQLDB：行为接近标准，但建议仍用列名方式增强可移植性；
-
Oracle：不支持自增主键原生语法（需序列+触发器），应改用
RETURNING子句（如INSERT ... RETURNING id INTO ?），此时不用getGeneratedKeys()。
不推荐：先查最大 ID 再插入（竞态风险）
有人尝试用 SELECT MAX(id) FROM table 猜下一个 ID，再手动设值插入——这在并发环境下极不可靠：
- 两个线程同时查到相同最大值，插入时会主键冲突或覆盖；
- 事务未提交时，
MAX(id)不可见，结果错乱； - 违反原子性，也不符合数据库设计原则。
务必使用 getGeneratedKeys() 这类由数据库保证原子性的机制。
