Spring Boot 2.7中JPA批量插入配置未生效，单条插入而非批量插入的问题求助

嗨，我来帮你分析下这个批量插入不生效的问题，从你给出的代码和配置来看，有几个关键的点可能导致Hibernate没有触发批量插入，我逐一给你梳理：

1. 缺失关键的Hibernate批量插入配置项 #

你只配置了hibernate.jdbc.batch_size，但要让Hibernate真正开启批量插入，还需要添加两个核心配置：

spring:
  jpa:
    properties:
      hibernate:
        jdbc:
          batch_size: 10000
        # 开启插入排序，确保同类型实体的插入语句被批量分组处理
        order_inserts: true
        # 开启批量版本数据处理，辅助优化批量操作逻辑
        jdbc.batch_versioned_data: true

其中hibernate.order_inserts=true是核心！Hibernate需要将相同实体类型的插入语句按顺序分组后，才能合并生成批量的INSERT语句，没有这个配置，它会按实体的处理顺序逐个生成单条语句，不会进行合并。

2. Persistable接口的isNew()实现可能干扰批量处理 #

你在Player实体中重写了isNew()并固定返回true，这会导致Hibernate始终将实体判定为全新状态，但更关键的是，这种硬编码的实现可能会干扰Spring Data JPA和Hibernate的批量状态判断逻辑。

对于明确插入全新记录的场景，其实不需要手动实现Persistable接口，你可以直接去掉该接口的实现，让Hibernate默认处理实体的持久化状态。如果业务上必须保留Persistable，建议优化isNew()的实现，通过临时字段标记实体是否为新：

public class Player implements Persistable<PlayerCompositeId> {
    @Id 
    Long leagueId;
    @Id 
    Long playerId;
    Integer numGames;
    
    @Transient
    private boolean isNew = true;

    @Override
    public boolean isNew() {
        return isNew;
    }

    @PostPersist
    public void markAsPersisted() {
        this.isNew = false;
    }

    // 其余代码保持不变
}

这样实体在被持久化后会自动标记为非新状态，避免状态判断错误影响批量逻辑。

3. 数据库驱动层面的批量支持缺失（以MySQL为例） #

如果你使用的是MySQL数据库，即使Hibernate生成了批量INSERT语句，MySQL JDBC驱动默认会将其拆分为单条执行，你需要在JDBC连接URL中添加rewriteBatchedStatements=true参数，让驱动真正合并批量语句：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true

这个配置是很多开发者容易忽略的，它直接决定了数据库驱动是否会执行真正的批量操作。

4. 手动验证批量插入的替代方案 #

如果添加上述配置后还是不生效，可以尝试绕开Spring Data JPA的saveAll()，直接使用Hibernate的Session手动执行批量插入，验证配置是否真的生效：

@Autowired
private EntityManager entityManager;

// 在你的业务方法中执行
List<Player> players = readPlayers(); // 返回25k条数据
Session session = entityManager.unwrap(Session.class);
int batchSize = 10000;

for (int i = 0; i < players.size(); i++) {
    session.persist(players.get(i));
    // 每达到批量大小就刷入数据库并清理缓存
    if (i % batchSize == 0 && i > 0) {
        session.flush();
        session.clear();
    }
}
// 处理剩余的实体
session.flush();
session.clear();

这种手动控制的方式可以直接验证Hibernate的批量配置是否正常工作，排除Spring Data JPA封装层的干扰。

5. 复合ID的潜在影响（已排除，但需确认） #

你的实体使用了复合ID，但复合ID本身不会阻止批量插入，而且你已经用Lombok的@Data正确实现了equals()和hashCode()，这部分是没问题的，不需要额外调整。

最后验证生效的方式 #

修改配置并重启应用后，可以通过两种方式验证：

1. 观察Hibernate日志：如果生成了包含多组(?, ?, ?)的批量INSERT语句，说明Hibernate层面的批量已生效；
2. 查看数据库性能：如果日志还是单条INSERT，但插入速度明显提升，说明MySQL驱动的rewriteBatchedStatements在生效（此时驱动会合并执行单条语句）。

建议你优先尝试添加hibernate.order_inserts=true和JDBC URL的rewriteBatchedStatements=true，这两个是解决批量插入不生效问题最常见的关键点。

内容来源于stack exchange