Java基本类型与包装类混用的核心隐患在于语义混淆：int=0表示“明确为零”，Integer=null表示“值缺失”；混用导致“未填”与“明确为零”无法区分，引发业务歧义、空指针及序列化不一致。
Java 中基本类型与包装类混用是常见隐患，重构核心在于明确语义、规避空指针、统一行为，并减少自动装箱/拆箱带来的性能与逻辑风险。
区分使用场景：值存在性决定类型选择
基本类型（int、boolean 等）代表“必须有值”的确定状态；包装类（Integer、Boolean 等）天然支持 null，适合表达“值可能缺失”的业务语义。
- 数据库字段允许为 NULL？用 Integer 或 LocalDateTime（非 long），配合 @Column(nullable = true) 显式表达可空性
- 方法参数表示“开关”或“标志位”，且不允许缺失？直接用 boolean，避免传入 null 导致 NullPointerException
- DTO 中某个数值字段在部分请求中不提供？定义为 Integer，并在业务层用 Objects.nonNull() 或 Optional.ofNullable() 判断是否设置
消除隐式装箱/拆箱：尤其在循环和集合操作中
在 for-each 循环遍历 ArrayList
javascript-typescript-typescript-scaffold
下载
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
- 高频计算场景（如统计、聚合）优先用基本类型数组或 IntStream：Arrays.stream(ints).sum() 比 list.stream().mapToInt(Integer::intValue).sum() 更直接
- 避免在 == 中比较包装类：用 Objects.equals(a, b) 或 a != null && a.equals(b) 替代 a == b，防止空指针和引用误判
- 集合初始化时，若元素确定为基本值且数量固定，考虑用 Arrays.asList(1, 2, 3) 返回 List
是安全的（编译器自动装箱），但不要在循环内反复调用 new Integer(x)
封装判空与默认值逻辑：避免散落各处的三元判断
重复写 value == null ? 0 : value 不仅冗余，还容易遗漏边界（如 Boolean.TRUE 的语义等价判断）。
立即学习“Java免费学习笔记（深入）”；
- 提取工具方法：Integers.orZero(Integer i)、Booleans.orFalse(Boolean b)，内部统一处理 null 和非法值
- 对关键业务字段，在 VO/DTO 中用 private final Integer status; + 构造器校验，搭配 getter 封装默认行为：public int getStatusValue() { return Optional.ofNullable(status).orElse(0); }
- 用 Lombok 的 @Builder.Default 或 @NonNull 配合构造器约束，比运行时判空更早暴露问题
统一序列化与反序列化行为
JSON 库（如 Jackson）对 null 包装类默认序列化为 null，而基本类型强制输出默认值（如 0、false），这可能导致前后端契约不一致。
- 全局配置 Jackson：用 @JsonInclude(JsonInclude.Include.NON_NULL) 让包装类字段不输出 null，同时基本类型字段保持显式存在（避免歧义）
- 反序列化时，若前端可能省略某数值字段，后端 DTO 必须用 Integer 接收，否则 Jackson 会填入 0（掩盖真实缺失）
- 必要时自定义 JsonDeserializer
，将空字符串、"null" 字符串、缺失字段统一转为 null，而非抛异常或设默认值
