NumberFormatException 是输入校验缺失的信号，应前置校验而非依赖 try-catch；推荐使用 Apache Commons Lang 的 NumberUtils 提供默认值、判断可创建性及自动 trim 的安全转换方法。
NumberFormatException 出现时，别急着 try-catch
它不是异常“发生了”，而是你本该提前挡住的信号。Java 的 Integer.parseInt()、Double.parseDouble() 这类方法只做转换，不负责校验——空字符串、纯空白、带单位的数字（如 "123px"）、科学计数法超限（如 "1e500"），全都会直接抛 NumberFormatException。
常见错误现象：Integer.parseInt(" ") 报错；Long.parseLong("99999999999999999999") 溢出报错；前端传来的 "null" 字符串被当字面量解析。
- 真正需要的是「能转才转」，而不是「转失败再兜底」
- 如果业务逻辑允许默认值（如 0 或 null），校验必须在 parse 前完成
- 注意
Integer.valueOf()和parseInt()行为一致，同样抛异常，别误以为包装类更“安全”
用 Apache Commons Lang 的 NumberUtils 更省心
自己写正则或 trim + isEmpty 判断，容易漏边界（比如 "
"、"＋123"、"0x1F"）。NumberUtils 提供了语义清晰的工具方法，底层已覆盖多数非数字输入场景。
使用场景：后端接收 HTTP 参数、配置文件读取、CSV 解析等不确定输入源。
立即学习“Java免费学习笔记（深入）”；
-
NumberUtils.toInt("123", -1)—— 转不了就用默认值，不抛异常 -
NumberUtils.isCreatable("12.5")—— 返回 boolean，适合做前置判断（支持小数、负数、带符号） -
NumberUtils.createInteger(" 456 ")—— 自动 trim，且返回Integer（可为 null），比parseInt多一层容错
注意：它不校验业务逻辑含义（比如“年龄不能为负”），只是语法合法性检查。
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
自定义校验时，正则要慎用
有人喜欢写 str.matches("-?\d+") 判断整数，但这个正则会放过 "-0"（合法）、拒绝 "+123"（其实 parseInt 支持），还无法处理千分位（如 "1,234"）或 Unicode 数字字符。
性能与兼容性影响：正则编译开销小，但维护成本高；对超长数字字符串（如 1000 位）做正则匹配可能意外变慢。
- 若必须用正则，优先用
NumberUtils.isCreatable()替代，它内部用的是 DFA，比正则更稳 - 需要支持小数？别手写
-?\d+\.?\d*，它会匹配 ".5" 和 "1."，而parseDouble()不认这两个 - 国际化场景下，
Character.isDigit()比\d更可靠（后者只匹配 ASCII 数字）
Spring Boot 接口参数校验怎么接住它
Controller 层收到字符串参数后，直接塞给 @RequestParam Integer id？不行。Spring 默认用 StringToNumberConverterFactory，失败时抛 MethodArgumentTypeMismatchException，但错误信息是英文、没上下文，前端难定位。
正确做法是把校验下沉到 DTO，并显式控制行为：
- 字段声明为
String id，然后在@Valid校验器里调用NumberUtils.isCreatable(id) - 或用自定义注解（如
@Numeric(min=1, max=999999)），在ConstraintValidator里调用NumberUtils.createLong(value)并判空 - 避免在
@InitBinder里全局注册StringToIntegerConverter，否则所有 String→int 转换都走同一套逻辑，灵活性差
容易被忽略的一点：HTTP 请求头里的数字型字段（如 X-Rate-Limit）也是字符串，别忘了它们。
