Sipios Spring Boot JPA Search枚举字段查询异常问题排查

针对你遇到的InvalidDataAccessApiUsageException类型不匹配问题，这里提供几个可行的解决方法：

方案1：自定义字符串转枚举转换器（推荐） #

Sipios Spring Search支持通过Spring的类型转换器处理参数类型转换，我们可以自定义转换器把请求中的字符串转成目标枚举类型：

1. 编写转换器类，实现Converter<String, 你的枚举类型>：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class MyEnumConverter implements Converter<String, MY_ENUM> {
    @Override
    public MY_ENUM convert(String source) {
        try {
            // 统一转大写避免大小写问题，也可根据实际需求调整
            return MY_ENUM.valueOf(source.toUpperCase());
        } catch (IllegalArgumentException e) {
            throw new IllegalArgumentException("无效的枚举值: " + source);
        }
    }
}

2. 确保这个类被Spring扫描到（比如添加@Component注解，或在配置类中手动注册）。

添加后，Sipios Spring Search解析查询参数时会自动调用这个转换器，将字符串"FIRST"转换为MY_ENUM.FIRST实例，匹配JPA字段的枚举类型。

方案2：使用全限定枚举值查询（适配旧版本） #

如果你使用的是0.2.3版本，可以尝试在查询值前加上枚举的全限定类名，比如：

localhost:8080/controller/search?search=enumField:com.yourpackage.MY_ENUM.FIRST

这个方式无需额外代码，但可读性较差，优先推荐方案1。

方案3：升级Sipios Spring Search版本 #

检查库的最新稳定版本，确认是否已经修复了枚举自动转换的问题，升级后再测试查询功能。

验证方法 #

启动应用后，发送请求localhost:8080/controller/search?search=enumField:FIRST，确认Hibernate不再抛出类型不匹配异常，且能正确返回目标数据。

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