java Optional 怎么避免误用

在 Java 中使用 Optional 的核心目标是明确“可能为空”的语义，并避免 NullPointerException，但 Optional 也很容易被误用。下面从常见误用场景 + 正确用法 + 最佳实践三个角度来说明。

一、最常见的误用 ❌

1️⃣ 把 Optional 当字段 / 方法参数

// ❌ 错误
class User {
    private Optional<String> email;
}

问题

• Optional 不是为“数据建模”设计的
• 增加序列化、性能、可读性成本

✅ 正确

class User {
    private String email; // 允许为 null 或空字符串
}

2️⃣ 作为方法参数传递

// ❌ 错误
void printName(Optional<String> name) {
    name.ifPresent(System.out::println);
}

问题

• 调用方必须包一层 Optional
• 语义混乱

✅ 正确

void printName(String name) {
    if (name != null) {
        System.out.println(name);
    }
}

3️⃣ 用 Optional.get() 不判空

// ❌ 危险
String name = optional.get(); // 可能 NoSuchElementException

✅ 正确

String name = optional.orElse("default");

或

optional.ifPresent(System.out::println);

4️⃣ 用 Optional 替代所有 null 判断

// ❌ 过度使用
Optional.ofNullable(list)
        .ifPresent(l -> l.forEach(...));

问题

• 可读性下降
• 没有实际收益

✅ 原则

Optional 用于返回值可能为空的“查询 / 计算”场景

二、推荐的正确使用方式 ✅

✅ 1. 作为方法返回值（最推荐）

public Optional<User> findUserById(Long id) {
    return userRepository.findById(id);
}

调用方：

findUserById(1L)
    .ifPresent(user -> System.out.println(user.getName()));

✅ 2. 提供默认值

String name = optional.orElse("unknown");
String name2 = optional.orElseGet(() -> expensiveDefault());

区别：

• orElse：无论如何都会执行
• orElseGet：只有为空才执行 ✅

✅ 3. 链式处理（避免嵌套 if）

Optional<User> userOpt = findUser();

userOpt
    .map(User::getAddress)
    .map(Address::getCity)
    .ifPresent(System.out::println);

✅ 4. 条件过滤

optional
    .filter(u -> u.getAge() > 18)
    .ifPresent(...);

✅ 5. 明确抛出异常

User user = optional.orElseThrow(
    () -> new IllegalArgumentException("User not found")
);

三、Optional 使用原则（经验法则）

✅ 适合用 Optional

• 方法可能“找不到结果”
• 返回值语义上允许为空
• 调用方需要被提醒“可能为空”

❌ 不适合用 Optional

• 实体类字段
• 方法参数
• 集合（用空集合代替）
• 性能敏感路径

四、一句话总结

Optional 不是“避免 null 的工具”，而是“表达意图的工具”。

如果你愿意，我也可以：

• 给你一份 Optional 使用规范清单
• 或结合你现有代码做 误用点审查