用Optional重构核心是推动空值逻辑显式化与边界清晰化，需识别可选性语义、隔离空值处理、避免链式滥用；适用于可能无结果的返回值，禁用于参数、字段及明确非空场景；分步替换：先改返回值为Optional.ofNullable，再改造调用方null检查，最后清理冗余分支；警惕误用：勿包装已有null检查、勿对Optional判null、勿过度链式调用；需同步更新Javadoc、统一空值响应、配合静态检查工具补全空安全契约。
用 Optional 重构老旧 Java 项目，核心不是“把 null 换成 Optional”，而是借它推动空值逻辑显式化、边界清晰化。重点在识别可选性语义、隔离空值处理、避免链式调用滥用。
先识别真正适合 Optional 的场景
Optional 适用于方法本意就可能无结果的返回值，比如查询数据库单条记录、从 Map 获取键对应值、解析配置项等。它不适用于：
- 方法参数（Optional 作参数是反模式）
- 字段/属性（成员变量不应为 Optional）
- 已明确非空的中间计算结果（如字符串 trim 后再判空）
- 异常流程（该抛 NullPointerException 或业务异常时，别用 empty() 隐藏问题）
分步替换：从返回值开始，不碰调用方
老旧代码常见 pattern：public User findUser(Long id) { return userDao.selectById(id); } —— 返回可能为 null。
重构步骤：
立即学习“Java免费学习笔记（深入）”；
- 第一步：改签名但保留旧逻辑，加注释说明意图：
public Optional<user> findUser(Long id) { return Optional.ofNullable(userDao.selectById(id)); }</user> - 第二步：在调用方逐步替换 null 检查，例如：
原写法：User u = findUser(123); if (u != null) { ... }
新写法：findUser(123).ifPresent(u -> { ... });或findUser(123).map(User::getName).orElse("未知用户"); - 第三步：清理旧的 null 判空分支，合并逻辑，让“有值做什么”和“无值怎么办”就近表达
警惕三类典型误用
不要包装已有 null 检查逻辑：
❌ 错误：return user != null ? Optional.of(user) : Optional.empty();
✅ 正确：直接用 Optional.ofNullable(user)，更简洁且语义一致。
不要在 Optional 上做 null 判空：
❌ 错误：if (optUser != null && optUser.isPresent()) { ... }
✅ 正确：只用 ifPresent、map/filter/flatMap 或 orElse 系列，让 Optional 自己管理状态。
不要链式过深导致可读性下降：
❌ 复杂嵌套：userOpt.flatMap(u -> u.getAddressOpt()).flatMap(a -> a.getCityOpt()).map(City::getName).orElse("N/A")
✅ 拆解或提取方法：getUserNameOrFallback(userOpt)，保持每层职责单一。
配套动作不能少
Optional 是信号灯，不是安全带：
- 同步更新 Javadoc，明确标注哪些方法返回 Optional 及其业务含义（如“未找到用户时返回 empty”）
- 在 service 层或 gateway 层统一处理 Optional.empty() → 返回 404 或默认 DTO，避免空值穿透到 controller
- 配合静态检查工具（如 SpotBugs + @NonNull 注解），在 Optional 之外的入参、返回值上补全空安全契约
