Java Optional 最佳实践是什么

在 Java 8+ 中使用 Optional<T> 的核心目标是明确“可能无值”的语义，避免 NPE，而不是把它当成一个“必定有值”的容器或到处滥用。下面从该用 / 不该用、常用 API、典型场景、反模式四个方面总结最佳实践。

一、Optional 的定位（很重要）

✅ Optional 是用来表达“返回值可能不存在”的语义类型
❌ 不是用来替代所有 null 检查
❌ 不适合做字段、方法参数、集合元素

官方建议：
Optional is not meant to be a general-purpose container, and it is not suitable for use as a field type.

二、最佳实践清单

1️⃣ 用作方法返回值（最推荐）

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

调用方被迫处理“可能不存在”：

Optional<User> user = findUserById(1L);
user.ifPresent(u -> System.out.println(u.getName()));

✅ 明确语义
✅ 编译器帮你“别忘了处理”

2️⃣ 不要用 Optional 做方法参数

❌ 错误示例：

public void updateUser(Optional<User> user) { ... }

✅ 正确做法：

public void updateUser(User user) {
    if (user == null) {
        ...
    }
}

或重载方法：

updateUser(User user)
updateUser() // 无参

原因：

• 增加调用方负担
• 可读性差
• Spring / JPA 等框架不支持

3️⃣ 不要用 Optional 作为类字段

❌ 错误：

class User {
    private Optional<String> email;
}

✅ 正确：

class User {
    private String email; // 允许 null
}

原因：

• 序列化问题
• 内存开销
• 不符合 Java Bean 规范

4️⃣ 不要用 Optional 包装集合

❌ 错误：

Optional<List<User>> users = ...

✅ 正确：

List<User> users = Collections.emptyList();

空集合优于 Optional<集合>

三、推荐使用的 API（按场景）

✅ 有值才做（最常用）

optional.ifPresent(value -> {
    // 有值逻辑
});

✅ 有值做 A，无值做 B

optional.ifPresentOrElse(
    v -> System.out.println(v),
    () -> System.out.println("无值")
);

✅ 提供默认值

String name = optional.orElse("default");
String name2 = optional.orElseGet(() -> generateName());

⚠️ 区别：

• orElse：无论有没有值都会执行
• orElseGet：只有无值时才执行

✅ 无值直接抛异常

User user = optional.orElseThrow(() -> new RuntimeException("用户不存在"));

✅ 链式转换（避免嵌套 null）

Optional<String> city = optional
    .map(User::getAddress)
    .map(Address::getCity);

⚠️ 注意：

• map 自动处理 null
• 不要 map(u -> Optional.of(u.getX()))（应用 flatMap）

✅ 条件过滤

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

四、常见反模式（一定要避免）

❌ 用 isPresent() + get() 当 null 检查

if (opt.isPresent()) {
    User u = opt.get();
}

✅ 改成：

opt.ifPresent(u -> ...);

❌ 把 Optional 当“必定有值”用

User u = opt.get(); // 可能 NoSuchElementException

❌ 没必要的地方用 Optional

Optional<Integer> add(Optional<Integer> a, Optional<Integer> b)

五、一句话总结

Optional 是“返回值可能不存在”的语义声明，不是 null 的替代品，也不是万能容器。

如果你愿意，我也可以：

• 给你 Optional vs null 的对比示例
• 讲 Stream + Optional 的组合用法
• 结合 Spring / JPA 实际场景讲怎么用最舒服