Integer.parseInt() 严格解析字符串为int,不接受null、空串、空格、非数字字符或溢出值,需前置校验和异常捕获;valueOf()返回缓存Integer对象;进制解析须先去除前缀;溢出时应改用BigInteger.intValueExact()等安全方式。

Integer.parseInt() 会直接抛出 NumberFormatException
它不接受 null、空字符串、带空格的字符串、非数字字符(包括中文数字、逗号、+/- 号位置错误)、超出 int 范围的数字。一旦不符合规范,立刻崩溃,不会返回默认值或 null。
常见报错信息:java.lang.NumberFormatException: null、java.lang.NumberFormatException: For input string: ""、java.lang.NumberFormatException: For input string: "123abc"
- 先用
str == null || str.trim().isEmpty()做前置校验 - 再用
str.trim().matches("-?\d+")粗筛格式(注意:这不能校验溢出) - 真正安全的做法是捕获
NumberFormatException并处理异常分支
parseInt() 和 valueOf() 的区别不只是返回类型
Integer.parseInt("123") 返回基本类型 int;Integer.valueOf("123") 返回 Integer 对象,且内部使用了缓存(-128 到 127 范围内复用对象)。
- 需要装箱或参与泛型容器(如
List)时,优先用valueOf() - 做纯数值计算、避免隐式装箱开销时,用
parseInt() - 二者在解析失败时行为完全一致——都抛
NumberFormatException
带进制解析必须确认字符串不含前缀
Integer.parseInt("0xFF", 16) 会失败,因为 "0xFF" 含有 0x 前缀,而该方法不识别任何前缀,只认纯数字字符(0–9, a–f/A–F)。
- 十六进制字符串要先去掉
"0x"或"0X",再调用parseInt(str.substring(2), 16) - 八进制同理:去掉开头的
"0"(注意不是所有以 0 开头的都是八进制,Java 字面量才这样,字符串里只是普通字符) - 二进制只支持字符
'0'和'1',不接受"0b101"这类前缀
大数或不确定范围时别硬刚 parseInt()
如果原始字符串可能超过 Integer.MAX_VALUE(2147483647)或小于 Integer.MIN_VALUE(-2147483648),parseInt() 会静默溢出——比如 parseInt("2147483648") 返回 -2147483648,而不是报错。
- 想严格拒绝溢出,改用
Integer.parseUnsignedInt()(仅限非负数)或Long.parseLong()+ 范围检查 - 更稳妥的是用
BigInteger:先new BigInteger(str),再调用intValueExact()—— 它会在溢出时明确抛ArithmeticException - Web 表单或日志解析等不可信输入场景,务必假设字符串长度 > 10 就存在溢出风险
实际用的时候,最常被忽略的是 trim() 和溢出校验。很多人写了 parseInt(s) 就以为稳了,结果线上因为前端多传了个空格或后端日志里混进了不可见字符直接挂掉。










