Spring Data JPA批量插入/更新失效，配置Hibernate批量参数仍无效

核心原因 #

Hibernate对于手动分配主键的实体，默认会触发merge操作而非persist：因为主键已赋值，Hibernate会先查询实体是否存在于数据库，导致无法进行批量处理，只能生成单条SQL。

具体解决步骤 #

1. 明确实体主键生成策略 #

在实体的@Id注解上指定GenerationType.ASSIGNED，告诉Hibernate主键由应用手动分配，无需自动生成：

@Id
@GeneratedValue(strategy = GenerationType.ASSIGNED)
private Long id;

2. 强制使用persist而非merge #

Spring Data JPA的saveAll()默认会根据主键是否为null判断实体状态，手动赋值主键后会走merge，需绕过这个逻辑：

方式一：自定义Repository批量插入方法

使用JPQL批量插入（需JPA 2.1+支持），直接生成批量SQL：

public interface TaskImageRepository extends JpaRepository<TaskImage, Long> {
    @Modifying
    @Transactional
    @Query("INSERT INTO TaskImage(id, taskId, imageUrl, createTime) VALUES (:id, :taskId, :imageUrl, :createTime)")
    void batchInsert(@Param("id") Long id, @Param("taskId") Long taskId, @Param("imageUrl") String imageUrl, @Param("createTime") LocalDateTime createTime);
}

如果需要批量传入多个实体，可结合数据库的批量参数支持（如MySQL的多行值语法），或者循环调用并控制批量提交时机。

方式二：直接使用EntityManager手动批量处理

最可靠的方式是通过EntityManager的persist方法，手动控制flush和clear，完全遵循Hibernate的批量配置：

@Service
public class TaskImageService {
    @PersistenceContext
    private EntityManager entityManager;

    @Transactional
    public List<TaskImage> batchSave(List<TaskImage> taskImages) {
        int batchSize = 20; // 与hibernate.jdbc.batch_size配置一致
        for (int i = 0; i < taskImages.size(); i++) {
            entityManager.persist(taskImages.get(i));
            // 每达到批量大小就flush并clear，避免一级缓存溢出
            if ((i + 1) % batchSize == 0) {
                entityManager.flush();
                entityManager.clear();
            }
        }
        // 处理剩余未提交的实体
        entityManager.flush();
        entityManager.clear();
        return taskImages;
    }
}

3. 补充关键配置（针对MySQL） #

如果使用MySQL，必须在数据源URL中添加rewriteBatchedStatements=true，否则MySQL JDBC驱动会把Hibernate生成的批量SQL拆成单条执行：

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

4. 验证批量效果 #

重新运行后，查看Hibernate统计：

• executing X JDBC batches的数量应接近总实体数 / batch_size
• 开启show_sql和format_sql后，控制台会显示包含多个值的批量插入SQL

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