Java自动装箱/拆箱易引发null异常、缓存陷阱、精度丢失和比较错误；应通过显式判空、用equals替代==、避免浮点包装类、启用编译警告及单元测试null分支来预防。
Java 中自动装箱（autoboxing）与拆箱（unboxing）本身是编译器层面的语法糖，运行时不会主动“校验”，但数据错乱往往源于隐式转换引发的 null 引用异常、精度丢失、缓存陷阱 或 比较逻辑错误。要防止错乱，关键不是事后校验，而是从编码习惯、类型选择和显式检查三方面提前规避。
避免 null 拆箱导致 NullPointerException
这是最常见也最危险的问题：当一个包装类引用为 null 时，编译器仍会自动生成拆箱代码，运行时报 NPE。
- ❌ 错误写法：
Integer a = null; int b = a; // 编译通过，运行抛 NPE - ✅ 安全做法：在可能为 null 的包装类参与运算前，显式判空或使用
Objects.requireNonNull()、Optional封装 - ✅ 更稳妥：优先使用基本类型变量接收；若必须用包装类，拆箱前加判断：
int value = (a != null) ? a : 0;
警惕 Integer 等缓存范围导致的 == 比较陷阱
Integer 在 -128 ~ 127 范围内复用缓存对象，超出该范围则每次 new 新对象，导致 == 比较结果不稳定。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- ❌ 危险写法：
Integer x = 128, y = 128; System.out.println(x == y); // false - ✅ 正确做法：一律用
.equals()比较包装类值（注意：它会先判 null，安全） - ✅ 进阶建议：如需高性能数值比较且确定非 null，可先
intValue()转基本类型再比
留意浮点数装箱/拆箱带来的精度与 NaN 风险
Double 和 Float 装箱后，== 比较 NaN 会恒为 false，且自动拆箱无法捕获精度误差。
立即学习“Java免费学习笔记（深入）”；
- ❌ 问题示例：
Double d = Double.NaN; boolean eq = (d == d); // false，违反直觉 - ✅ 推荐方式：用
Double.compare(d1, d2) == 0或Objects.equals(d1, d2) - ✅ 对精度敏感场景（如金额），禁用
float/double及其包装类，改用BigDecimal并显式控制舍入
静态分析与编译期辅助能提前发现隐患
仅靠人工难以覆盖所有边界，借助工具可主动拦截高危模式：
- 启用编译器警告：添加
-Xlint:autoboxing参数，让 javac 提示潜在装箱位置 - 集成 Checkstyle / PMD / SonarQube：配置规则检测 “null 拆箱”、“包装类 == 比较”、“float 包装类用于业务计算”等
- 单元测试覆盖 null 分支：对接受包装类参数的方法，必须包含传入
null的测试用例
