在Java里如何处理NumberFormatException_Java数字转换异常说明

P粉602998670 2026-01-14 00:00:00 次阅读

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

NumberFormatException 是什么，为什么它总在 parseXXX 时抛出

它不是运行时环境出错，而是你传给 Integer.parseInt()、Long.parseLong() 这类静态解析方法的字符串根本不符合数字格式。JVM 不会帮你猜意图，空字符串、纯空格、带字母的“123abc”、科学计数法“1.23e4”、甚至全角数字“１２３”，都会触发这个异常。

怎么安全地把字符串转成数字（不崩）

别直接调 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 更稳妥：

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，不能当作万能兜底。