Spring Boot JPA使用UUID批量保存列表仅成功一条的问题排查

核心问题分析 #

使用Spring Boot JPA的saveAllAndFlush批量插入3000-4000条WatchList记录时无报错，但仅成功插入一条，大概率是实体被JPA判定为同一实例导致，结合你的主键配置，具体排查方向如下：

1. 检查集合中实体的主键状态 #

你的主键配置为Hibernate自动生成UUID，正常情况下，未持久化的WatchList对象的pkWishListId应为null。如果集合中所有对象的主键被意外设置为同一个值，会导致JPA认为是同一实体，仅执行一次插入。

验证代码：

for (WatchList item : watchList) {
    System.out.println("WatchList ID: " + item.getPkWishListId());
}

如果输出中存在重复的ID或所有ID相同，需排查主键是否被手动赋值。

2. 排查equals/hashCode方法的实现 #

如果你的WatchList实体重写了equals和hashCode方法（比如使用Lombok的@Data注解），且方法基于主键字段生成，那么当主键为null时，所有未持久化的实体可能被判定为相等（若其他字段完全一致），导致集合中实际仅保留一个唯一实体（JPA在处理批量保存时会去重）。

修复方案：
修改equals/hashCode方法，基于业务唯一字段（如用户ID+关联商品ID）实现，而非主键：

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    WatchList watchList = (WatchList) o;
    return Objects.equals(getUserId(), watchList.getUserId()) 
        && Objects.equals(getProductId(), watchList.getProductId());
}

@Override
public int hashCode() {
    return Objects.hash(getUserId(), getProductId());
}

3. 主键生成策略的有效性验证 #

确认Hibernate版本与UUID生成策略兼容，org.hibernate.id.UUIDGenerator在Hibernate 5+版本中是稳定的，也可以尝试更换为JPA标准的UUID生成方式：

@Id
@GeneratedValue(strategy = GenerationType.UUID)
@Column(name = "PK_WISHLIST_ID", unique = true, nullable = false, length = 36)
private String pkWishListId;

（注意调整Column的length为36，符合UUID字符串长度）

4. 分批处理批量插入 #

单次saveAllAndFlush可能因Hibernate一级缓存或数据库批量插入限制导致异常，尝试分批插入降低单次处理的数据量：

int batchSize = 500;
for (int i = 0; i < watchList.size(); i += batchSize) {
    int endIndex = Math.min(i + batchSize, watchList.size());
    List<WatchList> batch = watchList.subList(i, endIndex);
    watchListRepo.saveAllAndFlush(batch);
    // 可选：清空一级缓存，避免内存溢出
    entityManager.clear();
}

总结 #

最常见的根因是equals/hashCode方法导致的实体去重，建议优先排查该点；其次验证主键生成状态，最后尝试分批插入优化性能。

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