Spring Boot中JPA Criteria Tuple查询GROUP BY关联字段缺失报错

你的问题核心是Criteria查询的SELECT子句包含了CameraZone的多个非聚合字段，但GROUP BY只指定了关联外键vehiclesto0_.zone_id，PostgreSQL的ONLY_FULL_GROUP_BY模式要求所有非聚合字段必须出现在GROUP BY中，因此触发报错。以下是具体修复方法：

方案1：显式将所有SELECT的非聚合字段加入GROUP BY #

如果需要在接口投影中获取CameraZone的id、name等字段，必须把这些字段全部加入GROUP BY子句，确保非聚合字段与分组规则匹配。

示例代码（Repository实现类）

@Repository
public class VehicleStoppedRepositoryImpl implements VehicleStoppedCustomRepository {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List<VehicleStoppedAggregate> getStoppedVehiclesCount() {
        CriteriaBuilder cb = entityManager.getCriteriaBuilder();
        CriteriaQuery<Tuple> query = cb.createTupleQuery();
        Root<VehicleStopped> root = query.from(VehicleStopped.class);
        Join<VehicleStopped, CameraZone> zoneJoin = root.join("cameraZone", JoinType.INNER);

        // 1. 定义查询字段：CameraZone属性 + 聚合函数
        Expression<Long> zoneId = zoneJoin.get("id");
        Expression<String> zoneName = zoneJoin.get("name");
        Expression<Long> totalCount = cb.count(root.get("id"));
        Expression<LocalDateTime> earliestStop = cb.min(root.get("stopTime"));
        Expression<LocalDateTime> latestStop = cb.max(root.get("stopTime"));
        Expression<Double> avgDuration = cb.avg(root.get("duration"));

        // 2. 组装SELECT子句，给字段起别名匹配接口投影方法
        query.multiselect(
                zoneId.alias("zoneId"),
                zoneName.alias("zoneName"),
                totalCount.alias("totalCount"),
                earliestStop.alias("earliestStop"),
                latestStop.alias("latestStop"),
                avgDuration.alias("avgDuration")
        );

        // 3. 将所有非聚合的CameraZone字段加入GROUP BY
        query.groupBy(zoneId, zoneName);

        // 执行查询并转换为接口投影
        List<Tuple> tuples = entityManager.createQuery(query).getResultList();
        SpelAwareProxyProjectionFactory factory = new SpelAwareProxyProjectionFactory();
        return tuples.stream()
                .map(tuple -> factory.createProjection(VehicleStoppedAggregate.class, tuple))
                .collect(Collectors.toList());
    }
}

对应的接口投影定义

public interface VehicleStoppedAggregate {
    Long getZoneId();
    String getZoneName();
    Long getTotalCount();
    LocalDateTime getEarliestStop();
    LocalDateTime getLatestStop();
    Double getAvgDuration();
}

方案2：按CameraZone主键分组（依赖函数依赖） #

如果你的CameraZone表中，name等字段是主键id的函数依赖（比如name由id唯一确定，数据库有唯一约束），可以只按CameraZone的主键分组。PostgreSQL在确认字段函数依赖的情况下，允许非分组字段出现在SELECT中：

// 仅按CameraZone主键分组
query.groupBy(zoneId);

这种方式生成的GROUP BY只会包含zone_id，但需要确保数据库中字段的依赖关系稳定，避免配置变更引发问题。

为什么Spring Data自动生成的接口投影能正常工作？ #

Spring Data JPA处理关联实体的分组查询时，会自动将关联实体的主键作为分组依据，同时确保SELECT中的非聚合字段要么是分组字段，要么是函数依赖字段，因此不会触发PostgreSQL的分组校验。手动编写Criteria时需要自行处理这些细节。

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