17370845950

NumberFormatException 是字符串不符合数字格式时抛出的运行时异常，常见于 parseInt 等方法解析含空格、字母、符号、空串、纯空白或超范围值的字符串。

NumberFormatException 是什么，为什么它总在 parseInt 时冒出来

它不是运行时意外，而是明确告诉你：字符串根本不符合数字格式。最常见于 Integer.parseInt()、Long.parseLong() 这类静态解析方法——只要传入的 String 含有空格、字母、符号（如 "123abc"、" 42 "、"null"），立刻抛出 NumberFormatException。

注意：Integer.valueOf() 行为一致，它底层也调用 parseInt()；而 Integer.decode() 支持前缀（如 "0xFF"），但不支持空白或杂字符，同样会抛该异常。

• 空字符串 "" → 抛异常（不是 0）
• 仅含空白的字符串 " " → 抛异常（trim() 不会自动执行）
• null 字符串 → 直接 NullP

  

  ointerException，不是 NumberFormatException
• 超出范围值如 "99999999999999999999"（远超 long）→ 抛异常，不是截断

怎么安全地把字符串转成数字（避免崩溃）

别依赖 try-catch 做流程控制，先做轻量校验。核心原则：**验证格式再解析，而非靠异常兜底**。

推荐组合使用 String.trim() + 正则 + 解析：

public static Optional 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 中用 过滤

真正难缠的不是语法错误，而是那些看起来像数字、实际混着 Unicode 零宽字符或 BOM 的字符串——它们不会在日志里显形，却让解析稳稳失败。上线前用真实脏数据压测输入清洗逻辑，比写十个 try-catch 更管用。