NumberFormatException在字符串无法解析为数字时抛出,常见于字符串转数字、用户输入处理、数据解析及进制转换场景,需通过异常捕获或预校验提升程序健壮性。

NumberFormatException 是 Java 中常见的运行时异常,属于 IllegalArgumentException 的子类。它主要在字符串无法解析为数字类型时抛出。下面介绍几个典型的使用场景和注意事项。
1. 字符串转数字操作
当使用 Integer.parseInt()、Double.parseDouble() 等方法将字符串转换为基本数据类型时,如果字符串内容不是合法的数字格式,就会抛出 NumberFormatException。
例如:- Integer.parseInt("abc") — 字母不能转成整数
- Double.parseDouble("3.14.15") — 多个小数点无效
- Long.parseLong("999xyz") — 包含非数字字符
- Byte.parseByte("300") — 超出 byte 范围(-128~127)
2. 用户输入处理
从控制台、表单或配置文件读取的数值通常以字符串形式存在。直接转换前若未校验格式,容易触发该异常。
建议做法:- 使用 try-catch 捕获异常,给出友好提示
- 提前用正则判断是否为合法数字格式,如:^\d+$ 或 ^-?\d+(\.\d+)?$
3. 数据解析与接口调用
在解析 JSON、CSV 或 URL 参数时,某个字段预期是数字,但实际值可能是空字符串、null 或拼写错误。
立即学习“Java免费学习笔记(深入)”;
比如:- JSON 中 "age": "unknown",代码尝试转成 int 会失败
- URL 参数 id=abc,服务端 parseLong 时报错
4. 字符串进制转换
使用 Integer.parseInt(str, radix) 指定进制时,若字符串包含不符合该进制的字符也会报错。
示例:- Integer.parseInt("2A", 16) — 合法(十六进制)
- Integer.parseInt("2G", 16) — G 不是十六进制有效字符
- Integer.parseInt("12", 1) — 进制基数不合法(必须 2-36)
基本上就这些常见情况。处理字符串转数字时保持警惕,合理捕获 NumberFormatException,能显著提升程序健壮性。不复杂但容易忽略。










