NumberFormatException 是字符串不符合数字格式时抛出的运行时异常，常见于 parseInt 等方法解析含空格、字母、符号、空串、纯空白或超范围值的字符串。
NumberFormatException 是什么，为什么它总在 parseInt 时冒出来
它不是运行时意外，而是明确告诉你：字符串根本不符合数字格式。最常见于 Integer.parseInt()、Long.parseLong() 这类静态解析方法——只要传入的 String 含有空格、字母、符号（如 "123abc"、" 42 "、"null"），立刻抛出 NumberFormatException。
注意：Integer.valueOf() 行为一致，它底层也调用 parseInt()；而 Integer.decode() 支持前缀（如 "0xFF"），但不支持空白或杂字符，同样会抛该异常。
- 空字符串
""→ 抛异常（不是0） - 仅含空白的字符串
" "→ 抛异常（trim()不会自动执行） -
null字符串 → 直接NullPointerException，不是NumberFormatException - 超出范围值如
"99999999999999999999"（远超long）→ 抛异常，不是截断
怎么安全地把字符串转成数字（避免崩溃）
别依赖 try-catch 做流程控制，先做轻量校验。核心原则：**验证格式再解析，而非靠异常兜底**。
推荐组合使用 String.trim() + 正则 + 解析：
立即学习“Java免费学习笔记（深入）”；
public static Optional<Integer> safeParseInt(String s) {
if (s == null) return Optional.empty();
String trimmed = s.trim();
if (trimmed.isEmpty() || !trimmed.matches("-?\d+")) return Optional.empty();
try {
return Optional.of(Integer.parseInt(trimmed));
} catch (NumberFormatException e) {
return Optional.empty();
}
}
- 正则
-?\d+覆盖正负整数，不含小数点、逗号、空格 - 必须先
trim()，否则" 123"会被正则拒绝 - 返回
Optional比返回默认值（如-1）更安全，避免业务误用“假数字” - 若需处理浮点数，改用
Double.parseDouble()+-?\d*\.?\d+，但注意科学计数法（"1e5"）需额外支持
为什么用 valueOf("123") 还是报 NumberFormatException
很多人以为 valueOf() 更“智能”，其实它和 parseInt() 在基础整数解析上行为完全一致。报错原因往往被忽略：
- 字符串带不可见字符：如 UTF-8 BOM（
"uFEFF123"）、零宽空格（"123"）→ 看似正常，实则匹配失败 - 用了全角数字：如
"１２３"（Unicode FF10–FF19）→ Java 数字解析只认 ASCII'0'–'9' - 日志打印时自动调用了
toString()，掩盖了原始内容；建议调试时用Arrays.toString(s.getBytes())查看真实字节
临时排查可加一行清洗：
s = s.replaceAll("\p{Cf}|\p{Z}", ""); // 清除格式控制符和空白类 Unicode 字符
从 JSON 或 HTTP 请求里取数字字段时的典型陷阱
前端传来的 {"age": "25"} 看似是字符串，但后端反序列化框架（如 Jackson）可能自动转成 int；而如果前端误传 {"age": ""} 或 {"age": null}，Jackson 默认配置下会尝试用空字符串构造 int，触发 NumberFormatException。
- Jackson：给字段加
@JsonSetter(nulls = Nulls.SKIP)或全局配置DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT - Spring MVC：用
@RequestParam接收时，空参数默认绑定为null，但若目标是基本类型int，会直接 400 错误；应改用包装类型Integer并配合required = false - MyBatis 查询结果映射：数据库字段为
VARCHAR但 Java 属性是Integer，空字符串或NULL映射时同样触发该异常——需在 XML 中用<if test="xxx != null and xxx != ''">过滤
真正难缠的不是语法错误，而是那些看起来像数字、实际混着 Unicode 零宽字符或 BOM 的字符串——它们不会在日志里显形，却让解析稳稳失败。上线前用真实脏数据压测输入清洗逻辑，比写十个 try-catch 更管用。
