NumberFormatException本质是字符串格式不合法，需预防性校验+业务化兜底：先用isBlank或正则筛查，再安全转换；捕获时记录上下文日志并返回用户友好提示；封装Optional工具方法复用；注意parseInt、valueOf、BigDecimal等差异。
Java 中遇到 NumberFormatException，本质是字符串内容不符合目标数字类型的格式要求，比如空串、纯空白、带字母、超出范围或使用了非标准符号（如中文逗号）。关键不是“捕获就完事”，而是要结合业务场景做**预防 + 合理兜底**。
先校验再转换，避免无谓抛异常
对用户输入、配置文件读取、接口返回的字符串，别急着调 Integer.parseInt()。用正则或工具类提前筛一遍：
- 检查是否为
null或空白：StringUtils.isBlank(str)（Apache Commons）或str == null || str.trim().isEmpty() - 粗略判断是否只含数字和可选正负号：
str.matches("-?\d+")（注意：不支持小数、科学计数法） - 对浮点数，可用
Double.valueOf(str)包裹在 try-catch 中——它比parseDouble更宽松（如接受 "1.2e3"），但依然会拒收非法格式
捕获异常时别只打印堆栈，要给出明确反馈
直接 e.printStackTrace() 对调试有用，但线上环境或用户交互中毫无意义。应转化为可理解的信息：
- 日志中记录原始字符串和上下文（如字段名、请求ID）：
log.warn("Invalid number format for 'age': '{}', request id: {}", input, reqId); - 面向用户的提示写清楚：“年龄只能填写整数，请检查输入” 而不是 “java.lang.NumberFormatException”
- 若属必填字段且格式错误，可返回 HTTP 400 状态码，并附带结构化错误信息
用 Optional 或工具方法封装转换逻辑
避免每个地方都写重复的 try-catch。封装成可复用的方法，返回 Optional 更安全：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
public static Optional<integer> safeParseInt(String s) {
if (s == null || s.trim().isEmpty()) return Optional.empty();
try {
return Optional.of(Integer.parseInt(s.trim()));
} catch (NumberFormatException e) {
return Optional.empty();
}
}</integer>
调用时直接链式处理：safeParseInt(input).orElse(0) 或 ifPresent(value -> process(value))，语义清晰且不易漏判。
注意不同 parse 方法的差异
同是转整数，不同方法行为不同：
-
Integer.parseInt(" 123 ")→ 成功（自动忽略首尾空白） -
Integer.parseInt("")或Integer.parseInt(" ")→ 抛NumberFormatException -
Integer.valueOf("123")内部也调parseInt，但返回Integer对象，适合需要装箱的场景 -
new BigDecimal(str)支持更广（如 "123.00", "1.23E+2"），但开销大；BigDecimal.valueOf(double)反而可能因 double 精度问题出错，慎用
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
