PostgreSQL 在执行包含 GROUP BY 子句的查询时，要求 SELECT 列表中所有未被聚合函数（例如 SUM, AVG, COUNT 等）处理的列，都必须出现在 GROUP BY 子句中。当使用 Hibernate 进行对象关系映射时，如果实体类的字段名与 SQL 关键字冲突，或者映射关系不正确，就可能触发此错误。本文将通过一个实际案例，详细讲解如何排查和解决这个问题。
问题分析
在提供的案例中，Album 实体与 AlbumCard 实体存在单向一对多关联。当尝试将 Album 实体映射到 AlbumModel 时，Hibernate 会执行以下 SQL 查询：
select album0_.id as id1_1_, album0_.is_public as is_publi2_1_, album0_.name as name3_1_, album0_.owner_id as owner_id4_1_ from albums album0_ where album0_.owner_id=? and album0_.id=? Hibernate: select cards0_.album_id as album_id8_0_0_, cards0_.id as id1_0_0_, cards0_.id as id1_0_1_, cards0_.card_id as card_id2_0_1_, cards0_.condition as conditio3_0_1_, cards0_.count as count4_0_1_, cards0_.design as design5_0_1_, cards0_.price as price6_0_1_, cards0_.updated as updated7_0_1_ from album_cards cards0_ where cards0_.album_id=?
根据错误信息 "column "cards0_.album_id" must appear in the GROUP BY clause or be used in an aggregate function"，问题可能出在 AlbumCard 实体中的 count 字段。count 是 SQL 中的一个聚合函数关键字，直接使用它作为字段名可能会导致 PostgreSQL 在执行查询时产生混淆。
解决方案
解决此问题的方法是避免使用 SQL 关键字作为实体类的字段名。可以通过以下两种方式解决：
-
重命名数据库列名:
在 AlbumCard 实体类中，使用 @Column 注解显式指定 count 字段对应的数据库列名。
@Entity @Table(name = "album_cards") public class AlbumCard { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private Integer price; private String condition; private String design; @Column(name = "card_count") // 显式指定列名 private Integer count; private Long cardId; @UpdateTimestamp private LocalDate updated; }修改后，Hibernate 将会使用 card_count 作为数据库列名，避免与 SQL 关键字 count 冲突。
-
重命名实体字段名:
如果不想修改数据库表结构，也可以直接修改实体类的字段名，避免使用 SQL 关键字。
@Entity @Table(name = "album_cards") public class AlbumCard { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private Integer price; private String condition; private String design; private Integer cardCount; // 修改字段名 private Long cardId; @UpdateTimestamp private LocalDate updated; }如果选择这种方式，需要确保所有使用到 count 字段的地方都同步修改为 cardCount。
注意事项
- 在设计数据库表结构和实体类时，尽量避免使用 SQL 关键字作为表名或字段名。
- 如果必须使用 SQL 关键字，一定要使用 @Column 注解显式指定列名，避免产生歧义。
- 在修改实体类字段名后，需要检查所有使用到该字段的地方，确保代码的正确性。
总结
"column must appear in the GROUP BY clause or be used in an aggregate function" 错误通常是由于字段名与 SQL 关键字冲突，或者映射关系不正确导致的。通过显式指定列名或修改字段名，可以有效解决这个问题。在开发过程中，应尽量避免使用 SQL 关键字，以提高代码的可读性和可维护性。
