PAYATHON 2026

如何检查 @BatchSize 对实际数据库查询次数的影响?

数据小陈

可以用 Hibernate Statistics 统计 SQL 语句数量,也可以通过 Session Metrics 日志辅助观察。当前测试只加载一个 OrderSummary 及其 items 集合,通常会执行两次查询。调整 @BatchSize 的值未必会改变这个结果。

为什么始终只有两次查询?

在这个映射中,@BatchSize(size = 5) 表示 Hibernate 一次批量加载最多可以初始化 5 个 OrderSummary.items 集合。它不限制每次查询返回的 Item 行数,也不限制整个测试执行的查询次数。

假设关联保持默认的延迟加载,缓存、其他关联和监听器也没有影响查询过程,当前测试通常会执行:

  1. entityManager.find(OrderSummary.class, 1L) 查询一个 OrderSummary。
  2. summary.getItems().hasSize(13) 对应的断言访问集合大小,触发 items 初始化,一次查询加载该集合中的全部 13 个 Item。

这里参与加载的只有一个集合。把 size 从 5 改为 10,不会改变加载这 13 个 Item 所需的查询次数。数据库中共有 20 个 Item,也不足以说明应该发生批量加载;需要看当前持久化上下文中有多少个待初始化的同类集合。

开启统计与日志

在测试配置中启用统计,并单独设置统计日志的级别:

spring:
  jpa:
    properties:
      hibernate.generate_statistics: true

logging:
  level:
    root: WARN
    org.springframework.web: INFO
    edu.orders.service: DEBUG
    org.hibernate.SQL: DEBUG
    org.hibernate.type.descriptor.sql.BasicBinder: TRACE
    org.hibernate.engine.internal.StatisticalLoggingSessionEventListener: INFO

root: WARN 会过滤未单独配置级别的 INFO 日志。将 org.hibernate.engine.internal.StatisticalLoggingSessionEventListener 设为 INFO,可以让它的统计信息通过日志级别过滤。hibernate.generate_statistics 则用于启用 Hibernate 统计。

Session Metrics 通常在 Session 结束时输出,不一定会在断言执行后立即出现。如果应用另外禁用了 Session 事件日志或替换了监听器,还需要检查相应设置。

注意 YAML 的缩进。问题中展示的配置如果直接保存为没有缩进的 YAML,不能形成预期的 logging.level 层级。

org.hibernate.type.descriptor.sql.BasicBinder 是 Hibernate 5 常用的参数绑定日志类别。使用 Hibernate 6 时,通常改为:

logging:
  level:
    org.hibernate.orm.jdbc.bind: TRACE

参数绑定日志用于查看参数,统计 SQL 数量时不必开启。

在测试中读取语句计数

直接读取 Statistics 比手动数日志行更方便。下面的示例保留原测试的加载方式,并增加语句计数:

@DataJpaTest(properties = {
    "spring.jpa.properties.hibernate.generate_statistics=true",
    "spring.jpa.properties.hibernate.cache.use_second_level_cache=false",
    "spring.jpa.properties.hibernate.cache.use_query_cache=false"
})
@ActiveProfiles("test")
class OrdersDbTest {

    @Autowired
    EntityManager entityManager;

    @Test
    void shouldExtractItemsFromOrder() {
        SessionFactory sessionFactory = entityManager
            .getEntityManagerFactory()
            .unwrap(SessionFactory.class);
        Statistics statistics = sessionFactory.getStatistics();

        entityManager.clear();
        statistics.clear();

        OrderSummary summary = entityManager.find(OrderSummary.class, 1L);
        assertThat(summary.getItems()).hasSize(13);

        long statementCount = statistics.getPrepareStatementCount();
        assertThat(statementCount).isEqualTo(2L);
    }
}

示例需要导入 org.hibernate.SessionFactory 和 org.hibernate.stat.Statistics。EntityManager 的包名应与项目版本一致,可能是 javax.persistence 或 jakarta.persistence。

2L 断言以上述条件为前提:执行一次父实体查询和一次集合查询,且测量期间没有其他 SQL。如果完整实体映射包含额外的 eager 关联,应根据实际 SQL 调整判断。

getPrepareStatementCount() 统计 JDBC statement 的准备次数。在这种没有写入和其他数据库操作的读取测试中,可以用它观察查询数量。它不是通用的 SELECT 执行计数器,测量期间的 INSERT、UPDATE 等语句也可能计入。getQueryExecutionCount() 无法覆盖所有实体加载和集合初始化产生的 SQL,因此不适合单独用于判断这个场景。

如何验证 @BatchSize 确实生效?

准备多个 OrderSummary,先将它们加载到同一个持久化上下文中,再逐个初始化 items。例如,可以在测试方法中使用以下测量过程:

entityManager.clear();

List<OrderSummary> summaries = entityManager.createQuery(
    "select s from OrderSummary s order by s.id",
    OrderSummary.class
).getResultList();

// Exclude the parent query from the measurement.
statistics.clear();

for (OrderSummary summary : summaries) {
    Hibernate.initialize(summary.getItems());
}

long collectionStatementCount = statistics.getPrepareStatementCount();
System.out.println("Collection statements: " + collectionStatementCount);

statistics 沿用上一段的获取方式,Hibernate 对应 org.hibernate.Hibernate。测试数据必须包含多个 OrderSummary;原问题中的 20 个 Item 并不等于 20 个父实体。

在没有缓存命中、集合尚未初始化且没有其他 SQL 的简单场景下,如果同一个持久化上下文中有 20 个待加载的 OrderSummary.items 集合,size = 5 时预计约有 4 次集合查询,size = 10 时约有 2 次。父实体查询已在计数前排除。具体批次仍需结合 Hibernate 版本和实际 SQL 确认,不能保证所有加载过程都有相同的查询次数。

观察 SQL 时,应检查一次集合查询是否覆盖多个 SUMMARY_ID。常见形式是带多个父实体标识符的 IN 条件,具体 SQL 形式可能随 Hibernate 版本和数据库方言变化。

测量时不要使用 JOIN FETCH 提前初始化集合,也不要在循环中调用 entityManager.clear()。前者会改变加载方式,后者会清掉参与批量加载的持久化上下文。Statistics 属于整个 SessionFactory,并行测试可能干扰计数,应让这类计数测试独立执行。

备注:内容仅供参考。