Spring Boot 3迁移后@BatchSize查询出现意外null的修复方案咨询

在Spring Boot 3（对应Hibernate 6+）中，@BatchSize的默认行为发生了变化：原本size属性是批量查询的最大ID数量限制，现在默认会将IN子句填充到size指定的长度，用null补全剩余位置。要恢复之前的逻辑，可以通过以下两种方式解决：

1. 全局配置（推荐） #

在Spring Boot的配置文件中添加Hibernate属性，全局修改批量查询的处理策略：

application.properties #

spring.jpa.properties.hibernate.query.batch_fetch_style=IN

application.yml #

spring:
  jpa:
    properties:
      hibernate:
        query:
          batch_fetch_style: IN

该配置会让Hibernate回到旧版逻辑：

• 当需要查询的ID数量小于等于size时，IN子句只包含实际存在的ID，不会填充null
• 当ID数量超过size时，自动拆分为多个批量查询，每个查询的IN子句最多包含size个ID

2. 局部配置（针对特定关联） #

如果不需要全局修改，可以在单个关联字段上通过@Fetch注解指定批量查询模式：

@Entity
public class Person {
    // 其他字段...

    @OneToOne
    @BatchSize(size = 10)
    @Fetch(value = FetchMode.SELECT, batchMode = BatchMode.IN)
    private Address address;
}

原因说明 #

Hibernate 6默认采用PADDED批量查询策略，用null填充IN子句到指定size，目的是让查询语句的参数数量保持一致，提升数据库查询计划缓存的效率。但这不符合旧版的预期行为，通过切换到IN策略即可恢复之前的批量查询逻辑。

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