在 Spring MVC 中需注册自定义 Converter<String, YourEnum> 实现字符串到枚举的转换，支持按 code 或 desc 等业务字段匹配，通过 WebMvcConfigurer 注册后，@RequestParam、@PathVariable 等参数可直接使用枚举类型。
在 Spring MVC 中，将请求参数（如 URL 查询参数或表单字段）中的字符串自动转换为枚举类型，需要注册一个自定义的 Converter<String, YourEnum>。Spring 默认不支持直接按枚举名（name()）以外的方式（比如按字段值、中文描述、自定义 code）转换，所以必须手动实现并注册。
定义带业务字段的枚举类
先让枚举支持可识别的业务标识，比如用 code 或 desc 字段代替默认的 name()：
public enum Status {
ENABLED(1, "启用"),
DISABLED(0, "禁用");
private final int code;
private final String desc;
Status(int code, String desc) {
this.code = code;
this.desc = desc;
}
// 提供根据 code 查找枚举的静态方法（关键！）
public static Status fromCode(int code) {
for (Status s : values()) {
if (s.code == code) return s;
}
throw new IllegalArgumentException("Unknown code: " + code);
}
// getter 省略...
}
编写 String 到 Enum 的 Converter
实现 Converter<String, Status>，支持按 code（数字字符串）或 desc（中文）等任意逻辑解析：
@Component
public class StatusConverter implements Converter<String, Status> {
@Override
public Status convert(String source) {
if (source == null || source.trim().isEmpty()) {
return null;
}
String trimmed = source.trim();
// 尝试按数字 code 匹配
try {
int code = Integer.parseInt(trimmed);
return Status.fromCode(code);
} catch (NumberFormatException ignored) {
// 再尝试按中文描述匹配（注意：生产环境建议用更明确的字段，如 code）
for (Status status : Status.values()) {
if (status.getDesc().equals(trimmed)) {
return status;
}
}
}
throw new IllegalArgumentException("Cannot convert '" + source + "' to Status");
}
}
注册 Converter 到 WebMvcConfigurer
Spring Boot 2.x+ 推荐通过 WebMvcConfigurer 注册，确保它参与全局类型转换：
立即学习“Java免费学习笔记（深入）”；
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addConverter(new StatusConverter());
// 也可注入其他 Converter Bean（@Component 已自动扫描）
// registry.addConverter(statusConverterBean);
}
}
Controller 中直接使用枚举参数
注册后，Controller 方法参数即可直接接收枚举，Spring 会自动调用你的 Converter：
@GetMapping("/api/orders")
public ResponseEntity<List<Order>> listByStatus(@RequestParam Status status) {
// http://localhost:8080/api/orders?status=1 → 解析为 ENABLED
// http://localhost:8080/api/orders?status=启用 → 解析为 ENABLED（如果 Converter 支持 desc）
return ResponseEntity.ok(orderService.findByStatus(status));
}
注意：路径变量（@PathVariable）、表单提交（@ModelAttribute）同样适用，只要参数类型是目标枚举且 Converter 已注册。
