0

0

Java中的NumberFormatException怎么预防_字符串数值转换校验技巧

P粉602998670

P粉602998670

发布时间:2026-03-16 08:27:25

|

843人浏览过

|

来源于php中文网

原创

NumberFormatException本质是字符串无法构成合法数值字面量的硬性解析失败,需前置校验空值、空白及进制参数,推荐用NumberUtils.isCreatable()安全判断后再解析,溢出仍抛异常。

java中的numberformatexception怎么预防_字符串数值转换校验技巧

NumberFormatException 本质是解析失败,不是格式错误

它抛出的直接原因是字符串无法被转成目标数值类型,比如 "123abc"Integer.parseInt(),或空串 ""、全空白 "\t\n "null 直接传入。这不是“格式不规范”的模糊问题,而是“根本不能构成合法字面量”的硬性失败。

常见错误现象:NumberFormatException: For input string: ""NumberFormatException: nullNumberFormatException: 0x1F(十六进制未指定进制参数)。

  • 务必先做非空和非空白校验:用 Objects.nonNull(s) + !s.trim().isEmpty()
  • 不要依赖 try-catch 做主流程控制——它开销大,且掩盖了本该前置拦截的问题
  • Integer.parseInt() 默认只认十进制;若要支持 "0xFF""101010",必须显式传进制参数,如 Integer.parseInt("0xFF", 16)

用 NumberUtils.isCreatable() 替代手写正则

Apache Commons Lang 的 NumberUtils.isCreatable() 是少数能安全覆盖多数边界场景的工具方法:它接受 "123""-45.67""+0.0""1.23e4",同时拒绝 "123.""123abc"" "null。比自己写正则更可靠,也比反复 try-catch 更轻量。

使用场景:表单提交、配置文件读取、CSV 解析等上游数据不可控的环节。

立即学习Java免费学习笔记(深入)”;

  • 引入依赖:org.apache.commons:commons-lang3:3.12.0 及以上
  • 判断后再解析:if (NumberUtils.isCreatable(str)) { return NumberUtils.createInteger(str); }
  • 注意:它不校验溢出(如 "99999999999999999999" 对 int 仍会抛异常),超长数需用 BigInteger 或提前截断

Long.parseLong() 和 Integer.parseInt() 的溢出行为完全一致

两者对超出范围的字符串(如 "2147483648"int,或 "9223372036854775808"long)都抛 NumberFormatException,而非静默截断或返回最大值。这点常被误认为“会绕过异常”,实际不会。

Gambo
Gambo

世界上首个游戏氛围编程智能体

下载

性能影响:溢出检测本身成本很低,但反复触发异常会显著拖慢吞吐——尤其在日志解析、批量导入等场景。

  • 若已知输入可能超范围,优先用 BigInteger 解析再比较:new BigInteger(str).compareTo(BigInteger.valueOf(Integer.MAX_VALUE))
  • 或用 Guava 的 Ints.tryParse() / Longs.tryParse(),返回 null 而非抛异常,适合高频校验
  • 避免在循环内对同一字符串反复调用 parseInt——解析结果应缓存或一次完成转换

JSON 反序列化时的 silent fallback 风险

像 Jackson 默认把无法转数字的 JSON 字符串(如 "abc")反序列化为 0 或 0L,而不是报错。这看似“友好”,实则掩盖了上游数据污染,后续计算出错才暴露,定位极难。

使用场景:微服务间 JSON 接口、前端传参、数据库 JSON 字段解析。

  • Jackson 应禁用 silent fallback:配置 DeserializationFeature.FAIL_ON_NUMBERS_FOR_ENUMS = false 不相关,真正要设的是 DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES = true,并配合自定义 JsonDeserializer 拦截非法字符串
  • Gson 默认更严格,但若用了 LenientDateFormat 类似宽松模式,也可能跳过校验——确认 GsonBuilder 未调用 lenient()
  • 最稳妥方式:在 DTO 字段上加 @JsonDeserialize(using = StrictNumberDeserializer.class),内部用 NumberUtils.isCreatable() 兜底

真正麻烦的不是“怎么转”,而是“谁该负责校验”。上游接口不校验、中间件默默 fallback、下游又用原始字符串拼 SQL——这种链路里,NumberFormatException 往往是最后一个被发现的症状,而不是第一个该拦截的点。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1071

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1132

2024.03.01

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

847

2023.08.22

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1570

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.4万人学习

Java 教程
Java 教程

共578课时 | 82.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号