Hibernate 6.2.x使用max函数处理枚举时触发QueryException问题

Hibernate 6.2.x版本对JPQL/HQL聚合函数的类型校验逻辑做了升级，max()函数要求参数必须是Comparable类型。虽然Java枚举默认实现了Comparable，但Hibernate 6.2的类型系统不再自动将@Enumerated(EnumType.STRING)映射的枚举字段识别为可比较类型，导致聚合函数调用失败。

提供三种可行的解决方式，按需选择：

方式一：查询时将枚举转换为字符串 #

修改HQL/JPQL查询语句，通过cast()将枚举字段转换为字符串类型后再调用max()——因为枚举以字符串存储，字符串的字典序匹配枚举name()的顺序：

select datasourceView.id, max(cast(datasourceView.datasourceStatus as string)) as DATASOURCE_STATUS_helper_column, datasourceView.id as ID_helper_column

方式二：使用AttributeConverter替代@Enumerated #

自定义枚举转换器，显式将枚举与字符串类型绑定，让Hibernate正确识别字段的可比较性：

1. 编写转换器类：

@Converter(autoApply = true)
public class DatasourceStatusConverter implements AttributeConverter<DatasourceStatus, String> {
    @Override
    public String convertToDatabaseColumn(DatasourceStatus status) {
        return status != null ? status.name() : null;
    }

    @Override
    public DatasourceStatus convertToEntityAttribute(String dbData) {
        return dbData != null ? DatasourceStatus.valueOf(dbData) : null;
    }
}

2. 修改实体字段映射，替换@Enumerated为@Convert：

@Column(name = "status")
@Convert(converter = DatasourceStatusConverter.class)
private DatasourceStatus datasourceStatus;

修改后原查询语句无需调整即可正常执行。

方式三：显式识别枚举的Comparable特性 #

如果需要基于枚举的自然排序（而非字符串字典序），可以在查询中显式将枚举转换为Comparable类型：

select datasourceView.id, max(cast(datasourceView.datasourceStatus as java.lang.Comparable)) as DATASOURCE_STATUS_helper_column, datasourceView.id as ID_helper_column

这种方式适用于依赖枚举自身排序逻辑的场景。

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