NumberFormatException 是解析字符串为数字时因格式非法抛出的运行时异常,常见于空字符串、含字母、全角数字、超范围值等场景;应校验或 try-catch 处理,推荐封装带默认值的方法并 trim 输入。

NumberFormatException 是什么,为什么它总在 parseXXX 时抛出
它不是运行时环境出错,而是你传给 Integer.parseInt()、Long.parseLong() 这类静态解析方法的字符串根本不符合数字格式。JVM 不会帮你猜意图,空字符串、纯空格、带字母的“123abc”、科学计数法“1.23e4”、甚至全角数字“123”,都会触发这个异常。
怎么安全地把字符串转成数字(不崩)
别直接调 parseInt,先做校验或用 try-catch 包裹。更推荐封装一个带默认值的工具方法:
public static int parseIntOrDefault(String s, int defaultValue) {
if (s == null || s.trim().isEmpty()) {
return defaultValue;
}
try {
return Integer.parseInt(s.trim());
} catch (NumberFormatException e) {
return defaultValue;
}
}
-
s.trim()必须加——否则“ 123 ”(带空格)也会报错 - 不要只 catch
Exception,必须明确捕获NumberFormatException - 如果业务允许,考虑用
OptionalInt替代默认值,让调用方决定兜底逻辑
哪些字符串看似像数字,实则一定会触发 NumberFormatException
这些是高频踩坑点,哪怕肉眼看着“没问题”:
- 空字符串:
"" - 仅空白字符:
"\t\n " - 前导/后缀非数字字符:
"123px"、"$456" - 超出范围的数值:
"99999999999999999999"(long 都装不下) - 带正负号但无数字:
"+"、"-" - 使用了 Locale 相关符号:比如德语环境下传入
"1.234,56"(逗号作小数点)
替代方案:用 BigDecimal 或 NumberFormat 处理复杂格式
如果你要处理货币、带千分位、多语言数字,Integer.parseInt() 就不该出场。用 NumberFormat 更稳妥:
立即学习“Java免费学习笔记(深入)”;
NumberFormat format = NumberFormat.getInstance(Locale.GERMAN);
try {
Number number = format.parse("1.234,56");
double value = number.doubleValue(); // 1234.56
} catch (ParseException e) {
// 注意:这里抛的是 ParseException,不是 NumberFormatException
}
注意 NumberFormat.parse() 抛的是 ParseException,和 parseInt 的异常类型不同;BigDecimal 构造函数虽然也接受字符串,但它对空格和前后缀更敏感,一样会抛 NumberFormatException,不能当作万能兜底。
NumberFormatException 反复出现的根因。










