Java包装类解析方法抛NumberFormatException，需结合上下文精准捕获；区分parseInt与valueOf行为差异，记录原始输入便于定位；预校验可减少异常频率，自定义工具方法提升可维护性。
Java 中包装类（如 Integer、Double 等）本身不会主动抛出异常，但它们的静态解析方法（如 Integer.parseInt()、Double.valueOf()）在输入格式不合法时会抛出 NumberFormatException。捕获这类异常的关键不是“泛泛地 try-catch”，而是结合上下文、输入来源和错误信息精准定位问题根源。
明确异常来源：区分 parse 与 valueOf 的行为差异
parseInt() 和 valueOf() 都可能抛出 NumberFormatException，但语义略有不同：
-
Integer.parseInt("abc")→ 直接抛NumberFormatException -
Integer.valueOf("123")→ 底层调用parseInt，同样抛相同异常 -
Integer.valueOf(null)→ 抛NullPointerException（注意：不是NumberFormatException）
所以，先确认你调用的是哪个方法、传入参数是否可能为 null，再决定捕获哪类异常。
捕获时保留原始输入，避免“丢失现场”
很多开发者只写 catch (NumberFormatException e) { log.error("转换失败"); }，这无法回溯是哪个字段、哪个值出错。正确做法是把原始字符串一并记录：
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
String input = request.getParameter("age");
try {
int age = Integer.parseInt(input);
} catch (NumberFormatException e) {
log.error("参数 age 解析失败，原始值='{}'", input, e);
throw new IllegalArgumentException("年龄格式错误：" + input, e);
}
这样日志里就能看到具体是 "age=abc" 还是 "age=""（空字符串）导致失败。
预校验比事后捕获更高效（尤其批量场景）
如果输入来自表单、CSV 或 JSON，建议在解析前做轻量校验：
- 判空：
StringUtils.isBlank(input) - 去首尾空格：
input.trim()再判断是否为空 - 正则粗筛：
input.matches("-?\d+")（仅适用于整数，不含科学计数法）
预校验不能替代 try-catch（比如超范围值 "2147483648" 仍需解析时才发现），但它能提前拦截明显非法输入，减少异常抛出频率，也便于分类统计错误类型。
自定义工具方法封装常见逻辑
把解析+日志+默认值逻辑统一收口，避免每个地方重复写 try-catch：
public static int parseInt(String s, String fieldName, int defaultValue) {
if (StringUtils.isBlank(s)) {
log.warn("字段 {} 值为空，使用默认值 {}", fieldName, defaultValue);
return defaultValue;
}
try {
return Integer.parseInt(s.trim());
} catch (NumberFormatException e) {
log.error("字段 {} 解析为 int 失败，值='{}'", fieldName, s, e);
return defaultValue;
}
}
调用时：int age = parseInt(request.getParameter("age"), "age", 0);，清晰、可维护、易追溯。
