Java包装类null导致拆箱NPE，需阻断null进入拆箱上下文并明确null语义：用Objects.equals替代==、算术前判空、流操作先filter、反射先接包装类再取值；优先基本类型或统一包装类+显式空处理。
Java 中基本类型本身不能为 null，而包装类（如 Integer、Boolean、Long 等）天然可空——这正是 null 值陷阱的根源。问题不在于“会不会出现 null”，而在于“null 何时悄悄触发拆箱并崩溃”。关键要守住两条线：一是阻止 null 进入拆箱上下文，二是让业务语义不被默认值污染。
避免隐式拆箱时的 NPE
以下写法看似简洁，实则高危，只要包装类为 null 就立即抛 NullPointerException：
-
if (status == true)或if (count != 5)→ 包装类与基本类型比较会自动拆箱 -
total = amount + tax;→ 参与算术运算即触发拆箱 -
list.stream().mapToInt(Integer::intValue).sum()→mapToInt内部调用intValue() -
int value = (int) method.invoke(obj);→ 强制转型触发运行时拆箱
✅ 安全替代方案：
- 统一用
Objects.equals(a, b)替代==或!=比较 - 算术运算前显式判空：
(amount != null ? amount : 0) + (tax != null ? tax : 0) - 流操作加过滤：
list.stream().filter(Objects::nonNull).mapToInt(Integer::intValue).sum() - 反射返回值先接包装类：
Integer ret = (Integer) method.invoke(...);，再判空后取值
显式控制 null 的语义表达
不能把 null 当作“暂时没想好”的占位符，而应主动定义它代表什么：
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 用
Optional<integer></integer>明确表达“可能不存在”：Optional.ofNullable(getAge()).orElse(0) - 方法参数强制非空：
Objects.requireNonNull(age, "age must not be null").intValue() - 工具类封装默认逻辑：
NumberUtils.toInt(age, -1)（Apache Commons）或自定义safeInt(Integer i, int def)
⚠️ 注意：Objects.requireNonNullElse(age, 0).intValue() 是安全的，但 Objects.requireNonNull(age).intValue() 顺序错误——校验发生在拆箱之后，无效。
从源头减少 null 包装类产生
防御性编程治标，设计优化治本：
- Dubbo/Feign 接口、MyBatis 查询、Jackson 反序列化等场景，配置默认值而非接受
null：@JsonSetter(nulls = Nulls.AS_EMPTY)或@Results(... nullValue="0") - DTO/VO 字段优先用基本类型（如
int status），除非需区分“0”和“未设置”；必须用包装类时，配合@NotNull+ 校验器 - 集合存储大量数值时，改用原始类型集合库（如 FastUtil 的
IntArrayList），彻底绕过包装类和 null - 数据库字段设为
NOT NULL并配默认值，避免 ORM 映射出null包装类
警惕业务语义被默认值覆盖
int age = 0 和 Integer age = null 在业务中含义完全不同：
-
0表示“用户年龄为零岁”（合法业务值） -
null应表示“用户未填写年龄”（缺失状态）
混用会导致逻辑误判。例如：
-
if (user.getAge() > 18)：若getAge()返回Integer且为null，直接 NPE；若返回int，则恒为0 > 18 == false，错误被静默掩盖 - 策略类中父类用
Boolean enabled，子类改用boolean enabled：JSON 缺失该字段时，父类得null，子类得false，行为不一致
建议同名业务字段在继承链、接口、DTO 中保持类型统一，优先全用包装类 + 显式空处理，或全用基本类型 + 数据库/序列化层兜底。
