Hibernate无法创建查询：自定义JPQL统计查询报错求助

核心问题分析 #

你的JPQL查询存在两个关键问题：

• 实体引用歧义：子查询中ServiceCategory.id未明确指向主查询的实体，导致JPA无法正确解析关联关系，引发语法或逻辑错误。
• 子查询效率低下：逐个分类执行子查询的方式性能较差，且容易出现统计漏洞（比如无对应座位的分类无法正确返回0）。

修正后的查询（推荐方案） #

使用JOIN + GROUP BY替代子查询，逻辑更清晰且性能更优：

@Query("""
    SELECT sc.name, COUNT(s.id) AS seatCount
    FROM ServiceCategory sc
    LEFT JOIN Seat s ON sc.id = s.serviceCategory.id
        AND s.aircraft.tailNumber = :aircraftTailNumber
    GROUP BY sc.id, sc.name
    """)
List<Object[]> countSeatsGroupByServiceCategory(String aircraftTailNumber);

• LEFT JOIN确保即使分类下没有对应飞机的座位，也会返回该分类并统计为0；若仅需统计有座位的分类，替换为INNER JOIN即可。
• 给主查询的ServiceCategory设置别名sc，明确关联关系，避免歧义。

额外优化建议 #

1. 明确返回结果类型
   避免使用Collection<?>，改用List<Object[]>，后续处理可直接通过索引取值：

List<Object[]> results = repository.countSeatsGroupByServiceCategory("B-1234");
for (Object[] result : results) {
    String categoryName = (String) result[0];
    Long seatCount = (Long) result[1];
    // 业务处理逻辑
}

2. 使用DTO封装结果（更优雅）
   创建专用DTO类接收统计结果：

public class SeatCountByCategory {
    private String categoryName;
    private Long seatCount;

    public SeatCountByCategory(String categoryName, Long seatCount) {
        this.categoryName = categoryName;
        this.seatCount = seatCount;
    }

    // 生成getter和setter
}

修改查询语句直接实例化DTO：

@Query("""
    SELECT new com.your.package.SeatCountByCategory(sc.name, COUNT(s.id))
    FROM ServiceCategory sc
    LEFT JOIN Seat s ON sc.id = s.serviceCategory.id
        AND s.aircraft.tailNumber = :aircraftTailNumber
    GROUP BY sc.id, sc.name
    """)
List<SeatCountByCategory> countSeatsGroupByServiceCategory(String aircraftTailNumber);

3. 检查关联实体完整性
   确保Aircraft实体中存在tailNumber字段，且注解配置匹配数据库列：

@Entity
@Data
@NoArgsConstructor
@Table(name = "aircraft")
public class Aircraft {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;

    @Column(name = "tail_number")
    private String tailNumber;
    // 其他字段...
}

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