Java Optional 怎样把空值转换为异常信息

从数据库、缓存或参数对象取值时，结果可能是一个真实对象，也可能是空值。如果继续调用 get()，空值分支只会得到缺少业务上下文的 NoSuchElementException。更清楚的写法是先用 Optional.ofNullable 表达“可能没有结果”，再用 orElseThrow 指定异常类型和异常信息。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Optional.html

核心写法是 Optional.ofNullable(value).orElseThrow(() -> new IllegalArgumentException("用户不存在"))：有值就返回值，为空才创建并抛出带消息的异常。

• ofNullable 把 null 变成 empty，把非 null 变成 present。
• orElseThrow 的 Supplier 只负责空值分支的异常构造。
• 异常类型和消息应描述调用方真正需要处理的业务边界。

先把可能为空的数据放进 Optional

假设仓储层通过编号查询用户，返回值可能是 null。入口处应使用 ofNullable，不要先把 null 放进普通变量后再调用方法。这样，数据源、空值状态和后续异常处理之间的关系是明确的。

// 查询结果可能为空，先把 null 转成 Optional.empty()
Optional user = Optional.ofNullable(userRepository.findById(userId));

// 有值时继续携带 User，空值时保留 empty 状态
String userName = user.map(User::getName).orElse("未命名用户");

ofNullable 适合接收外部返回的可空值；如果调用方已经能保证对象非 null，才使用 Optional.of。后者遇到 null 会立即抛出 NullPointerException，它不是“把空值转换成业务异常”的入口。

用 orElseThrow 指定异常类型和消息

需要把空值转换为异常时，调用带 Supplier 参数的 orElseThrow。Supplier 返回哪个异常，空值分支就抛出哪个异常；消息放在异常构造器中，调用方拿到的就是可定位问题的文本。

// 空值表示用户不存在，抛出调用方能够识别的业务异常
User user = Optional.ofNullable(userRepository.findById(userId))
        .orElseThrow(() -> new UserNotFoundException("用户不存在，id=" + userId));

// 有值时直接返回 User，不会创建上面的异常对象
return user;

这里的 Lambda 不是装饰写法，而是一个延迟的异常工厂：Optional 有值时不会调用它，只有空值时才创建异常。也可以使用无参数构造器的方法引用，例如 orElseThrow(UserNotFoundException::new)；如果必须把编号或原因写进消息，就使用 Lambda。

检查异常消息、类型与 Supplier 边界

要注意三点。第一，Supplier 本身不能为 null；第二，在空值分支中，Supplier 也不能返回 null，否则仍会得到 NullPointerException。第三，消息应包含可定位的业务信息，但不要把密码、令牌等敏感内容拼进异常文本。

常见问题

orElseThrow 和 get 有什么区别？

两者都可能在空值时抛异常，但 get() 使用固定的 NoSuchElementException，不能表达业务原因；带 Supplier 的 orElseThrow 可以指定异常类型和消息。

为什么不直接用 orElse(null)？

orElse(null) 会把空值继续传给后面的代码，异常位置可能被推迟到另一个方法。需要把“没有结果”变成明确失败时，应在边界处使用 orElseThrow。

消息应该写在哪里？

写在异常构造器中，例如 new UserNotFoundException("用户不存在，id=" + userId)。这样异常类型负责分类，消息负责定位；调用方可以按类型处理，日志则保留必要上下文。

因此，Java Optional 把空值转换为异常信息的最小闭环就是：可空数据进入 ofNullable，空状态到达 orElseThrow，Supplier 创建指定异常，异常消息说明具体原因。只要让异常类型、消息和调用边界保持一致，代码就比直接调用 get() 更容易排查。