Spring Boot自定义枚举作为@RequestParam转换失败求助

在Spring Boot的getRooms接口中，内置枚举Sort.Direction作为@RequestParam参数时能自动完成字符串到枚举的转换，但自定义枚举SourceFunding始终转换失败，调用接口传入sourceFunding=PUBLIC_INSURANCE这类参数时返回400错误。手动调用SourceFunding.valueOf()也报错，但能正常打印所有枚举值。

核心诊断 #

手动调用SourceFunding.valueOf()报错，本质原因是传入的字符串与枚举常量的name()不匹配，或者枚举使用了自定义属性而非枚举名作为参数值，导致Spring默认的枚举转换器无法识别。

解决方案 #

步骤1：验证枚举常量名称与传入参数的一致性

先通过代码打印所有枚举常量的name()，确认是否和你传入的参数完全一致（包括大小写、下划线等）：

for (SourceFunding sf : SourceFunding.values()) {
    System.out.println("枚举名称：" + sf.name());
}

如果输出的名称和你传入的PUBLIC_INSURANCE不一致（比如是PUBLICINSURANCE或拼写错误），直接修改传入的参数值匹配枚举名称即可解决问题。

步骤2：自定义Spring转换器（当参数值与枚举名无法统一时）

如果因为业务需求必须使用特定格式的参数值（比如带下划线的字符串），可以自定义Spring的Converter来实现字符串到枚举的转换：

2.1 编写转换器类

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

@Component
public class SourceFundingConverter implements Converter<String, SourceFunding> {
    @Override
    public SourceFunding convert(String input) {
        // 遍历枚举常量，支持大小写不敏感匹配，或匹配自定义属性
        for (SourceFunding funding : SourceFunding.values()) {
            // 可根据实际需求调整匹配逻辑，比如匹配枚举名、自定义value属性等
            if (funding.name().equalsIgnoreCase(input) 
                || funding.getValue().equalsIgnoreCase(input)) {
                return funding;
            }
        }
        throw new IllegalArgumentException("无效的SourceFunding参数：" + input);
    }
}

注：如果你的枚举有自定义属性（比如private final String value），记得在匹配逻辑里加入对该属性的判断。

2.2 确保转换器被Spring扫描

给转换器类加上@Component注解，让Spring自动扫描并注册这个转换器。如果转换器不在Spring的扫描路径下，也可以在配置类里手动注册：

import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new SourceFundingConverter());
    }
}

额外排查点 #

• 检查控制器的@RequestParam参数名是否和请求中的参数名一致（比如控制器里是sourceFunding，请求里是不是写成了source_funding）。
• 确认枚举类的定义没有拼写错误，比如常量名是不是少写了字符、大小写错误等。

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