Spring Boot中如何用JPA CriteriaBuilder实现count(*)替代count(id)

在Spring Boot 3.3 + Hibernate + PostgreSQL的场景下，默认使用criteriaBuilder.count(root)会生成COUNT(id)的SQL查询，而COUNT(*)在PostgreSQL中通常性能更优（尤其是当表存在大量非空字段或索引优化有限时）。以下是几种实现COUNT(*)的方案：

方案1：直接指定COUNT(1)（与COUNT(*)等价） #

PostgreSQL中COUNT(1)和COUNT(*)的执行计划完全一致，都能高效统计行数。可以通过传入字面量1来实现：

CriteriaQuery<Long> counter = criteriaBuilder.createQuery(Long.class);
Root<?> root = counter.from(YourEntity.class);
// 使用count(1)替代count(root)
counter.select(criteriaBuilder.count(criteriaBuilder.literal(1)));

这段代码会生成SELECT COUNT(1) FROM your_table的SQL，和COUNT(*)性能无差异。

方案2：通过Hibernate配置全局启用COUNT(*) #

如果希望所有count查询都默认生成COUNT(*)，可以在application.properties或application.yml中添加Hibernate专属配置：

# application.properties
hibernate.query.count_star_parameter=true

或者YAML格式：

# application.yml
spring:
  jpa:
    properties:
      hibernate:
        query:
          count_star_parameter: true

开启这个配置后，原本的criteriaBuilder.count(root)就会自动生成COUNT(*)的SQL，无需修改代码。

方案3：使用CriteriaBuilder的countDistinct（去重统计场景） #

如果需要统计不重复的行数，也可以用countDistinct结合字面量1来生成COUNT(DISTINCT *)：

counter.select(criteriaBuilder.countDistinct(criteriaBuilder.literal(1)));

补充说明 #

PostgreSQL对COUNT(*)的优化优于COUNT(id)的原因：

• COUNT(*)会优先使用表的元数据统计（若表无频繁写入）或最有效的索引；
• COUNT(id)需要遍历id字段的索引，若id是自增主键且数据量较大，扫描成本更高。

内容的提问来源于stack exchange，提问作者Iori Yagami