Payara 5中CriteriaQuery将Enum转为序号而非字符串问题求助

针对你遇到的问题——实体枚举字段已标注@Enumerated(EnumType.STRING)，但CriteriaBuilder生成的查询仍使用枚举序号而非字符串——可通过以下几种方式解决：

方法一：使用类型安全的Metamodel属性引用 #

字符串形式的属性获取（from.get("myEnum")）可能无法正确识别实体字段的@Enumerated注解配置，改用JPA Metamodel的类型安全引用可彻底解决该问题：

1. 项目中启用JPA Metamodel生成（例如Maven中添加EclipseLink的注解处理器依赖org.eclipse.persistence:org.eclipse.persistence.jpa.modelgen.processor），自动生成对应实体的Metamodel类（如OptionHandler_）。
2. 修改查询代码，替换字符串属性名为Metamodel的类型化引用：

public List<OptionHandler> get(MyEnum myEnum) {
    if (myEnum == null) {
        log.warning("No enum given!");
        return List.of();
    }

    final var builder = getEntityManager().getCriteriaBuilder();
    final var query = builder.createQuery(OptionHandler.class);
    final var from = query.from(OptionHandler.class);
    query.select(from);

    // 替换字符串属性名为Metamodel引用
    final var match = builder.equal(from.get(OptionHandler_.myEnum), myEnum);
    query.where(match);

    final var typedQuery = getEntityManager().createQuery(query);
    return typedQuery.getResultList();
}

方法二：手动将枚举转换为字符串值 #

若暂时无法使用Metamodel，可直接传递枚举的字符串名称作为查询条件：

// 替换原match行，手动传入枚举的字符串值
final var match = builder.equal(from.get("myEnum"), myEnum.name());

该方式简单直接，但缺点是属性名字符串硬编码，后期字段名变更时易出错。

方法三：升级Payara 5的EclipseLink版本 #

Payara 5默认使用EclipseLink作为JPA实现，部分旧版本的EclipseLink存在CriteriaBuilder处理@Enumerated(EnumType.STRING)的bug。可升级至Payara 5的最新补丁版本，或手动替换EclipseLink依赖为2.7.x系列的稳定新版。

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