使用JPA和Hibernate实现批量插入/更新与PostgreSQL日志不符问题

嘿，我之前也碰到过一模一样的情况！这个问题其实是PostgreSQL JDBC驱动的批量处理逻辑和Hibernate的配置交互导致的，咱们一步步来拆解：

核心原因 #

你看到的Hibernate日志显示批量大小是10（3次）+5（1次），但PostgreSQL日志里却拆成了8+2、8+2、8+2、4+1的组合——这完全是PostgreSQL JDBC驱动（pgjdbc）在偷偷拆分你的批量！

当Hibernate按照你设置的jdbc.batch_size=10把插入请求发给驱动后，默认配置下的pgjdbc会把单条批量插入拆分成更小的批次。从你的日志看，每条实体插入需要8个参数（对应SQL里的$1-$8），驱动默认的拆分逻辑会把参数总数控制在某个阈值内，导致10条的批量被拆成8条（64个参数）+2条（16个参数）的组合。

快速解决方案 #

最直接的修复方式是调整PostgreSQL JDBC URL的参数，强制驱动按照你期望的批量大小来处理：

jdbc:postgresql://<你的地址>:<端口>/<数据库名>?reWriteBatchedInserts=true&batchSplitSize=10

这里两个参数的作用：

• reWriteBatchedInserts=true：开启驱动的批量重写功能，把多个单条INSERT合并成一个带多VALUES子句的SQL，这本来就是提升批量插入性能的关键配置
• batchSplitSize=10：指定每个合并后的SQL最多包含10条记录，和你设置的Hibernate批量大小完全对齐，避免驱动再乱拆分

额外验证点 #

除了调整驱动参数，你还可以检查以下几点确保配置没问题：

• 确认你用的是saveAll()方法插入数据，并且插入过程中没有手动调用flush()或者触发查询（比如插入中间执行findById）——这些操作会强制Hibernate提前执行当前批次，打乱批量逻辑
• 你的实体用了BatchSequenceGenerator预生成ID，这没问题，但要确保没有其他字段使用@GeneratedValue（除了ID），否则会干扰批量插入
• 再核对一遍Hibernate的批量配置，确保这些参数都正确开启：

spring:
  jpa:
    properties:
      hibernate:
        order_inserts: true  # 必须开启，确保同类型实体的插入被合并
        order_updates: true
        batch_versioned_data: true
        jdbc:
          batch_size: ${JDBC_BATCH_SIZE:10}

预期效果 #

调整完驱动参数后，你再看PostgreSQL日志，就会看到和Hibernate日志一致的批量大小：3次10条插入、1次5条插入，不会再出现零散的8条、2条拆分了。

我当初碰到这个问题的时候，一开始以为是Hibernate的配置没生效，查了半天才发现是驱动在搞鬼，调整batchSplitSize之后立刻就正常了！

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