java Optional 如何避免空指针

在 Java 中，Optional 是专门用来显式表达“可能为空的值”，从而帮助避免 NullPointerException 的容器类（Java 8 引入）。下面从常见错误用法、正确用法和最佳实践几个方面说明。

一、Optional 的核心思想

不要用 null 表示“没有值”，用 Optional.empty() 表示“没有值”

Optional<String> name = Optional.ofNullable(getName());

这样调用方被迫处理“可能为空”的情况，而不是默认它一定有值。

二、避免空指针的常用方式

1️⃣ 不要直接 get()（最容易踩坑）

❌ 错误用法：

Optional<String> opt = ...
String value = opt.get(); // 可能抛 NoSuchElementException

✅ 正确方式：

✅ orElse（有默认值）

String value = opt.orElse("default");

✅ orElseGet（延迟计算）

String value = opt.orElseGet(() -> generateDefault());

✅ orElseThrow（明确异常）

String value = opt.orElseThrow(() -> new RuntimeException("value is null"));

2️⃣ 用 ifPresent 避免显式判空

❌ 传统写法：

if (user != null) {
    System.out.println(user.getName());
}

✅ Optional 写法：

Optional<User> userOpt = ...
userOpt.ifPresent(u -> System.out.println(u.getName()));

3️⃣ 用 map 安全取值（链式调用）

❌ 容易 NPE：

String city = user.getAddress().getCity();

✅ 安全写法：

Optional<User> userOpt = ...

String city = userOpt
    .map(User::getAddress)
    .map(Address::getCity)
    .orElse("Unknown");

✅ 即使中间任何一层为 null，也不会抛异常。

4️⃣ flatMap 处理返回 Optional 的方法

Optional<Order> orderOpt = ...

Optional<String> productNameOpt = orderOpt
    .flatMap(Order::getProductOpt);

map 用于普通返回值
flatMap 用于返回 Optional 的方法

5️⃣ filter 做条件判断

Optional<User> adminOpt = userOpt
    .filter(u -> u.getRole().equals("ADMIN"));

如果条件不满足，变成 Optional.empty()

三、Optional 不要怎么用（反模式）

❌ 不要作为类字段

class User {
    Optional<String> name; // 不推荐
}

原因：

• 增加序列化复杂度
• 破坏对象语义
• 官方不推荐

✅ 正确做法：

class User {
    String name; // 允许 null
}

❌ 不要作为方法参数

void print(Optional<String> text) // 不推荐

✅ 推荐：

void print(String text) {
    Optional.ofNullable(text).ifPresent(System.out::println);
}

❌ 不要为了用而用

Optional.of("hello").get(); // 毫无意义

四、实际开发推荐模式

✅ 返回值可能为空的方法

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

✅ 调用端安全消费

userService.findUserById(1L)
    .ifPresent(user -> log.info(user.getName()));

五、总结一句话

Optional 不是用来“消灭 null”，而是用来“强迫你处理 null”

避免空指针的关键原则

• ❌ 不随便 get()
• ✅ 用 orElse / ifPresent / map
• ✅ 明确“可能没有值”
• ✅ 只在返回值中使用 Optional

如果你愿意，我也可以结合 真实业务代码 或 Spring / MyBatis 场景 给你具体示例。