配置quarkus.hibernate-orm.jdbc.statement-batch-size后Hibernate批量删除未生效？

你遇到的问题核心在于：循环执行JPQL DELETE语句的方式无法触发Hibernate的批量操作，哪怕配置了quarkus.hibernate-orm.jdbc.statement-batch-size也没用。下面是具体原因和解决方案：

问题原因 #

Hibernate的批量更新/删除机制针对的是实体的生命周期操作（比如em.remove(entity)），而不是循环执行独立的JPQL DELETE语句。你当前的代码中，每次调用executeUpdate()都会直接向数据库发送一条单独的删除请求，Hibernate不会将这些请求合并成批量操作。

解决方案 #

方案1：使用实体移除（em.remove()）实现批量删除 #

这种方式会触发Hibernate的批量处理，配合配置即可生效。

步骤1：完善配置

在application.properties中添加以下配置：

# 开启批量处理
quarkus.hibernate-orm.jdbc.statement-batch-size=1000
# 禁用JDBC批量操作的版本检查（针对非乐观锁实体）
quarkus.hibernate-orm.jdbc.batch-versioned-data=false
# 可选：开启批量操作日志，验证是否生效
quarkus.log.category."org.hibernate.engine.jdbc.batch.internal.BatchingBatch".level=DEBUG

步骤2：修改删除代码

将循环执行JPQL DELETE改为循环调用em.remove()，并在合适的时机手动flush和clear，避免内存溢出：

@QuarkusTest
class BookDeleteIT {
  @Inject EntityManager em;

  @Test
  void deletes_records_in_batches() {
    List<Book> books = getBooks();
    deleteBooks(books);
  }

  @Transactional
  List<Book> getBooks() {
    return em.createQuery("SELECT b FROM Book b").getResultList();
  }

  @Transactional
  void deleteBooks(List<Book> books) {
    int batchSize = 1000;
    for (int i = 0; i < books.size(); i++) {
      em.remove(books.get(i));
      // 每达到批量大小就flush并clear
      if (i % batchSize == 0 && i > 0) {
        em.flush();
        em.clear();
      }
    }
    // 处理剩余的实体
    em.flush();
    em.clear();
  }
}

方案2：使用IN子句一次性删除（更高效） #

如果不需要加载实体到内存，直接使用IN子句拼接ID集合，一次执行删除操作，这种方式性能更高，且不需要依赖Hibernate的批量配置：

@Transactional
void deleteBooks(List<Book> books) {
  // 提取所有ID
  List<Long> bookIds = books.stream().map(Book::getId).toList();
  // 使用IN子句执行批量删除
  em.createQuery("DELETE FROM Book b WHERE b.id IN :ids")
    .setParameter("ids", bookIds)
    .executeUpdate();
}

注意：部分数据库对IN子句的参数数量有限制（比如PostgreSQL默认是65535），如果ID数量超过限制，可以拆分多个批次执行。

方案3：启用Hibernate的批量DML操作（针对JPQL批量更新/删除） #

如果你坚持使用JPQL的DELETE语句批量执行，可以开启Hibernate的参数填充配置，让Hibernate自动将多个小批量合并成合适的批量请求：
在application.properties中添加：

quarkus.hibernate-orm.query.in-clause-parameter-padding=true

然后拆分ID集合为多个小批次，每个批次执行一次IN子句的DELETE：

@Transactional
void deleteBooks(List<Book> books) {
  List<Long> bookIds = books.stream().map(Book::getId).toList();
  int batchSize = 1000;
  // 拆分ID集合为多个批次
  for (int i = 0; i < bookIds.size(); i += batchSize) {
    int end = Math.min(i + batchSize, bookIds.size());
    List<Long> batchIds = bookIds.subList(i, end);
    em.createQuery("DELETE FROM Book b WHERE b.id IN :ids")
      .setParameter("ids", batchIds)
      .executeUpdate();
  }
}

验证批量是否生效 #

开启DEBUG日志后，如果看到类似以下日志，说明批量操作已生效：

DEBUG [org.hib.eng.jdb.bat.int.BatchingBatch] (main) Executing batch size: 1000

内容的提问来源于stack exchange，提问作者Rob van Maris