使用Spring Data JPA的entityManager.merge()仅持久化列表最后一条记录问题

这种问题我之前踩过好几次坑，大概率是下面几个原因导致的，咱们一步步拆解排查：

1. 两条实体的主键值重复了 #

entityManager.merge()的核心逻辑是：如果实体的主键在数据库中已存在，就会更新这条记录；如果不存在才会执行插入。如果你的两个summary对象主键完全相同，那第一条会被第二条覆盖，最终数据库里只会留下最后一条。

这种情况往往和你用的自定义sequenceGenerator有关：

• 可能是sequence的配置错误（比如数据库里的sequence增量值设为0，或者注解里的allocationSize和数据库sequence的INCREMENT BY不匹配）；
• 也可能是你创建summary对象时，错误地给两个对象设置了相同的主键值（比如复制对象时没有重新生成主键）。

排查方法：在merge前打印每个summary的主键值，确认是否重复：

summaryList.stream().forEach(summary -> {
    System.out.println("当前Summary主键：" + summary.getId());
    entityManager.merge(summary);
});

2. 事务未正确提交或未触发持久化同步 #

Spring Data JPA默认会在事务提交时，才把持久化上下文的变更同步到数据库。如果你的这段代码不在事务上下文里，或者没有手动触发刷新，可能只有最后一条变更被真正执行。

修复方法：

• 确保执行这段代码的方法被@Transactional注解包裹（这是最推荐的方式）；
• 可以在循环结束后手动调用entityManager.flush()，强制把所有变更同步到数据库：

summaryList.stream().forEach(summary -> entityManager.merge(summary));
entityManager.flush(); // 强制同步到数据库

3. 实体对象是同一个引用的副本 #

如果你是通过复制同一个实体对象、修改属性后加入列表的，比如：

Summary baseSummary = new Summary();
// 设置基础属性
Summary summary1 = baseSummary;
summary1.setName("A");
Summary summary2 = baseSummary;
summary2.setName("B");
summaryList.add(summary1);
summaryList.add(summary2);

这种情况下，summary1和summary2其实是同一个对象的引用，merge的时候本质上是在操作同一个实体，最终只会保存一次。

修复方法：确保每个summary都是全新的实例，不要直接复制引用。

4. 自定义sequenceGenerator配置错误 #

检查实体类上的主键生成注解是否正确：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "summary_seq")
@SequenceGenerator(
    name = "summary_seq",
    sequenceName = "SUMMARY_SEQUENCE", // 要和数据库里的sequence名称一致
    allocationSize = 1 // 要和数据库sequence的INCREMENT BY值一致
)
private Long id;

如果allocationSize和数据库sequence的增量不匹配，可能导致主键重复生成，进而触发merge的更新逻辑。

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