Spring使用Specification按枚举名称查询报类型不匹配异常

这个报错的原因其实很直接：你的实体类里对应字段的类型是application.springEnum.Hello枚举，JPA在处理Specification查询时，会严格按照实体类的字段类型来校验参数，哪怕数据库里存的是VARCHAR字符串。JPA默认会把枚举类型的字段和数据库的字符串做映射（如果你加了@Enumerated(EnumType.STRING)的话），但查询时它还是期望你传入枚举实例，而不是原始字符串，这就是为什么传"HELLO"会触发类型不匹配的异常。

下面给你几个实用的解决方案：

方案1：把查询字符串转换成枚举实例再查询 #

这是最直接的做法，先将字符串转为对应的枚举对象，再传入查询条件里：

Specification<DTO> spec = (root, query, cb) -> {
    String targetEnumStr = "HELLO";
    // 把字符串转成枚举实例
    Hello targetEnum;
    try {
        targetEnum = Hello.valueOf(targetEnumStr);
    } catch (IllegalArgumentException e) {
        // 处理字符串不匹配枚举的情况，比如直接返回无结果的条件
        return cb.disjunction();
    }
    return cb.equal(root.get("yourEnumFieldName"), targetEnum);
};

⚠️ 注意：Hello.valueOf()会在字符串没有对应的枚举值时抛出异常，所以一定要加异常处理，避免程序崩溃。如果不想自己写判断，可以用Apache Commons Lang的EnumUtils工具类来安全转换：

Hello targetEnum = EnumUtils.getEnum(Hello.class, targetEnumStr);
if (targetEnum == null) {
    return cb.disjunction();
}

方案2：将枚举字段转为字符串类型后再比较 #

如果你不想提前转换枚举，可以在Specification里把实体类的枚举字段强制转为字符串类型，再和目标字符串做比较：

Specification<DTO> spec = (root, query, cb) -> {
    String targetEnumStr = "HELLO";
    // 将枚举字段转为String类型后执行等值匹配
    return cb.equal(root.get("yourEnumFieldName").as(String.class), targetEnumStr);
};

这种方式绕过了JPA的枚举类型校验，直接基于数据库存储的字符串值做查询，适合你这种数据库存VARCHAR的场景。

额外提醒：确保枚举映射配置正确 #

如果你的实体类还没加@Enumerated(EnumType.STRING)，一定要补上这个注解，不然JPA默认会把枚举的序号（ordinal）存在数据库里，而不是枚举名称字符串，这会导致后续查询完全不符合预期：

@Entity
@Getter @Setter @NoArgsConstructor @AllArgsConstructor @Builder
public class DTO {
    @Id
    private Long id;
    
    // 加上这个注解，明确枚举按名称字符串存储
    @Enumerated(EnumType.STRING)
    private Hello yourEnumFieldName;
    
    // 其他字段...
}

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