MyBatis批量插入并返回自增主键在MySQL中可行，但需同时满足四个条件：表主键设为AUTO_INCREMENT、JDBC URL禁用rewriteBatchedStatements=true、XML或注解中正确配置useGeneratedKeys="true"和keyProperty、传入非空集合，缺一不可。
MyBatis 批量插入并返回自增主键在 MySQL 中是可行的，但不是“开箱即用”——必须同时满足 4 个条件：数据库表主键设为 AUTO_INCREMENT、JDBC URL 不启用 rewriteBatchedStatements=true、XML 或注解中正确配置 useGeneratedKeys="true" 和 keyProperty、传入的是非空集合。缺一不可。
MySQL 表结构和 JDBC URL 必须匹配
批量回填主键依赖 MySQL 驱动对 getGeneratedKeys() 的实现，而这个 API 在 rewriteBatchedStatements=true 下会被绕过（驱动改用单条语句合并优化，丢失逐行主键映射能力）。所以即使你写了 useGeneratedKeys="true"，URL 里开着这个参数，id 字段也永远是 null 或默认值。
- ✅ 正确 JDBC URL 示例：
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai - ❌ 错误配置（禁用）：
...&rewriteBatchedStatements=true - 表主键必须显式声明为
AUTO_INCREMENT，例如：id BIGINT PRIMARY KEY AUTO_INCREMENT - MyBatis 不校验数据库定义，如果建表时漏了
AUTO_INCREMENT，插入成功但id不会回填，也不会报错
XML 方式：<insert> 标签里写对三个属性
useGeneratedKeys 和 keyProperty 必须写在 <insert> 标签内，不能写在 <mapper> 或全局配置里；keyProperty 值必须严格匹配 Java 实体类的字段名（注意大小写、Lombok 生成的 setter 名），不是数据库列名，也不是 getter 方法名。
-
useGeneratedKeys="true"：启用 JDBC 的getGeneratedKeys()调用 -
keyProperty="id"：对应实体类中字段名为id的属性（如private Long id;） -
keyColumn一般不用写；仅当数据库列名与实体字段名差异大、且驱动不自动映射时才指定，比如列叫user_id但字段叫userId，可加keyColumn="user_id" -
<foreach>内部的collection名必须和接口方法参数上的@Param一致，如@Param("users") List<User> list，则collection="users"
<insert id="batchInsert" useGeneratedKeys="true" keyProperty="id">
INSERT INTO user (name, age) VALUES
<foreach collection="users" item="u" separator=",">
(#{u.name}, #{u.age})
</foreach>
</insert>
注解方式：用 @Options + @Insert 组合
注解写法容易漏掉 @Options，或把 keyProperty 写成数据库列名（如 "user_id"）——它只认 Java 字段名。另外，@Insert 内必须包裹 <script>，否则 <foreach> 不生效。
-
@Options(useGeneratedKeys = true, keyProperty = "id")必须和@Insert在同一个方法上 -
@Param("users")不可省略，否则 MyBatis 无法识别collection="users" - 不要试图在
@Insert字符串里硬编码keyProperty，它只在@Options中起作用 - 若实体类字段是嵌套的（如
address.id），keyProperty="address.id"会静默失败，MyBatis 不报错也不赋值
@Insert("<script>INSERT INTO user (name, age) VALUES " +
"<foreach collection='users' item='u' separator=','>" +
"(#{u.name}, #{u.age})</foreach></script>")
@Options(useGeneratedKeys = true, keyProperty = "id")
int batchInsert(@Param("users") List<User> users);
执行后主键怎么拿到？别调 return 值
MyBatis 的批量插入方法返回的是影响行数（int），不是主键列表。主键是直接回填到传入的每个实体对象里的——这是最常被忽略的一点。你得遍历原集合去取，而不是期待方法返回一个 List<Long>。
- 插入前：创建
List<User> users = new ArrayList<>();，每个User的id是null或0 - 插入后：
userMapper.batchInsert(users);执行完，users.get(0).getId()就已是数据库生成的真实值 - ⚠️ 注意：如果集合为空（
users.isEmpty()），SQL 会变成INSERT INTO ... VALUES后无内容，MySQL 报语法错误，整个事务回滚 - MyBatis-Plus 的
saveBatch()默认不回填主键，它走的是 JDBCaddBatch，不调getGeneratedKeys()；要用就换insertBatchSomeColumn或手写 SQL
真正卡住人的从来不是语法，而是 JDBC 参数和数据库行为的隐式耦合——比如 rewriteBatchedStatements 看似优化性能，实则关掉了主键回填能力；又比如 keyProperty 写错大小写，MyBatis 一声不吭，id 就一直为 null。动手前先确认这四件事：表主键是否 AUTO_INCREMENT、URL 是否关了批量重写、XML/注解里 useGeneratedKeys 和 keyProperty 是否同级存在、集合是否非空。
