Spring JPA中批量插入实体列表的最优方案

兄弟，你现在这种循环逐个调用save()的方式确实会拖慢速度——每次调用都会触发一次单独的数据库请求，来回的网络开销、事务处理会累积成不小的性能损耗。下面给你讲讲Spring JPA里真正高效的批量插入方案，亲测好用：

1. 优先用saveAll()方法，但要配对参数 #

Spring Data JPA的JpaRepository本身就提供了saveAll(Iterable<T>)方法，不过默认情况下它可能还是在循环执行单条插入，得加配置让它变成真正的批量操作。

代码示例 #

首先你的Repository只要继承JpaRepository就行：

public interface CustomerRepository extends JpaRepository<Customer, Long> {
}

然后业务层直接调用：

List<Customer> custList = ...; // 你的客户实体列表
custRepository.saveAll(custList);

2. 关键配置（没这些等于白用） #

要让saveAll()真正批量执行，必须在配置文件里加以下参数，以application.properties为例：

# MySQL的话，URL必须加rewriteBatchedStatements=true，驱动才会把多条插入合并成批量语句
spring.datasource.url=jdbc:mysql://localhost:3306/your_db?rewriteBatchedStatements=true&useSSL=false
spring.datasource.username=root
spring.datasource.password=your_password

# Hibernate批量插入核心配置
spring.jpa.properties.hibernate.jdbc.batch_size=100 # 每批插入的数量，建议50-200之间，根据DB性能调整
spring.jpa.properties.hibernate.order_inserts=true # 让Hibernate把同类型的插入语句排序，提升批量效率
spring.jpa.properties.hibernate.jdbc.batch_versioned_data=true # 如果实体有版本字段（@Version），开启这个保证批量更新/插入的正确性

⚠️ 注意：如果你的实体用了@GeneratedValue(strategy = GenerationType.IDENTITY)（自增主键），Hibernate的批量插入会失效——因为它需要先获取每条记录的主键值，只能单条插入。这时候可以改成SEQUENCE或者TABLE生成策略，或者MySQL的话保持IDENTITY但必须开rewriteBatchedStatements=true，驱动会帮你优化。

3. 超大列表的进阶处理（几万/几十万条） #

如果你的列表特别大，直接一次性saveAll()可能会导致内存溢出。这时候可以分批次处理，每批插入一部分，还可以手动清理EntityManager缓存：

int batchSize = 100;
EntityManager entityManager = ...; // 可以通过@Autowired注入

for (int i = 0; i < custList.size(); i += batchSize) {
    int endIndex = Math.min(i + batchSize, custList.size());
    List<Customer> batch = custList.subList(i, endIndex);
    
    custRepository.saveAll(batch);
    // 手动flush，把缓存里的SQL发送到数据库
    entityManager.flush();
    // 清空一级缓存，释放内存
    entityManager.clear();
}

这样每批处理完就释放内存，避免OOM。

额外提醒 #

• 尽量把批量操作放在一个事务里，但如果批次太大，记得调整事务超时时间（比如@Transactional(timeout = 300)）。
• 测试的时候可以开启SQL日志，看看是不是真的生成了批量插入语句（比如MySQL会显示INSERT INTO customer (...) VALUES (...), (...), (...)）。

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