Enum.valueOf() 找不到枚举常量时必然抛 IllegalArgumentException，属正常设计；应通过 try-catch 显式处理，配合 trim() 和空值校验，并用遍历实现大小写不敏感解析。
Enum.valueOf() 抛出 IllegalArgumentException 是正常行为，不是 bug
Java 的 Enum.valueOf() 在找不到对应枚举常量时，**一定会抛出 IllegalArgumentException**，而不是返回 null 或默认值。这是设计使然——它定位的是“严格匹配”，不处理拼写错误、空格、大小写偏差等常见脏数据。所以指望它“静默失败”或“自动容错”是走错方向。
真正要做的，是把异常捕获作为控制流的一部分，而非掩盖问题：
- 用
try-catch捕获IllegalArgumentException，不是为了“兜底”，而是为了明确区分“输入合法但不存在”和“输入格式非法”（比如 null、空字符串） - 注意：
NullPointerException会在传入null时抛出，它和IllegalArgumentException是不同异常，需分别处理或提前校验 - 不要 catch
Exception，避免吞掉本该暴露的编程错误（如类加载失败）
推荐写法：先校验再转换，避免重复解析
直接裸调 Enum.valueOf() 并在 catch 里 fallback，容易让逻辑分散。更清晰的做法是封装一个带默认值的工具方法，内部统一处理边界：
public static MyEnum parse(String s, MyEnum defaultValue) {
if (s == null || s.trim().isEmpty()) {
return defaultValue;
}
try {
return MyEnum.valueOf(s.trim());
} catch (IllegalArgumentException e) {
return defaultValue;
}
}
关键点：
- 显式 trim()：防止前后空格导致匹配失败（
"ACTIVE "≠"ACTIVE"） - 先判空再进
valueOf()：避免触发NullPointerException，让两种错误路径分离 - 不建议在 catch 块里尝试 toUpperCase()/toLowerCase() 自动纠错——这会掩盖命名规范问题，且可能引入歧义（如
"active"和"ACTIVE"同时存在时）
需要忽略大小写的场景，别硬改 valueOf()，用遍历 + equalsIgnoreCase
Java 枚举没有内置大小写不敏感的解析方法。Enum.valueOf() 是严格大小写敏感的，强行在 catch 后转大写再试一次，属于“打补丁式容错”，可读性和性能都不好。
更稳妥的方式是手动遍历：
public static MyEnum parseIgnoreCase(String s) {
if (s == null) return null;
for (MyEnum e : MyEnum.values()) {
if (e.name().equalsIgnoreCase(s.trim())) {
return e;
}
}
return null;
}
注意：
- 遍历性能 OK（枚举项通常
- 如果枚举项极多（罕见），且调用频繁，可预建
Map（key 全小写），但要注意初始化时机和线程安全 - 别用
s.toUpperCase().valueOf()：String.valueOf()不是枚举方法，会编译失败
Spring Boot 中 @RequestParam/@PathVariable 绑定失败时的默认行为
如果你在 Controller 层用 @RequestParam MyEnum status，Spring 默认会用 Enum.valueOf() 解析，失败时抛 MethodArgumentTypeMismatchException，最终返回 400 Bad Request。
想自定义 fallback 或提示信息，有两条路：
- 加
@InitBinder注册自定义PropertyEditor或Converter，在 convert 方法里做 try-catch + 默认值 - 改用
@RequestParam String statusStr，手动调用你封装好的parse(statusStr, MyEnum.DEFAULT) - 避免全局配置
spring.mvc.throw-exception-if-no-handler-found=true以外的异常处理器覆盖这个行为——否则可能把本该 400 的请求变成 500
复杂点往往不在转换逻辑本身，而在「谁该负责校验」：前端传参格式、API 文档约定、后端 fallback 策略，三者不一致时，try-catch 写得再稳也会埋雷。
