Java Optional orElseThrow空值时未抛出异常问题排查

问题现象 #

根据JDK官方文档，Optional.orElseThrow(Supplier<? extends X> exceptionSupplier)的逻辑为：值存在时返回该值，值不存在时抛出异常供应器生成的异常：

public T orElseThrow​(Supplier<? extends X> exceptionSupplier) throws X
如果值存在则返回该值，否则抛出异常供应函数生成的异常。

在Spring Boot + JPA Repository的业务代码中，已经通过断点确认isPresent()返回false（即无有效值），但orElseThrow(RuntimeException::new)未触发异常抛出，业务代码如下：

public AttractionOverview getAttractionOverviewById(int attraction_id) throws NoSuchElementException {
    Optional<AttractionOverview> overview = this.attractionOverviewRepository.findAttractionOverviewById(attraction_id);
    overview.isPresent();
    return overview.<RuntimeException>orElseThrow(RuntimeException::new);
}

相同逻辑的纯Java测试代码可以正常抛出异常：

public class OptionalThrows {
public static void main(String[] args) throws Exception {
    Optional<Object> empty = Optional.empty();
    Object aThrow = empty.orElseThrow(() -> new RuntimeException("Nothing to see here"));
    System.out.println(aThrow);
}
}

根因排查（按出现概率从高到低排序） #

• 异常被上层逻辑静默吞掉
  这是最高发的原因。Spring Boot应用中常见的全局异常处理器、Controller切面、事务拦截器、业务层统一catch逻辑如果写了catch (Exception e) { // 无日志无重抛 }的代码，会直接吞掉RuntimeException，观测时会误以为orElseThrow没有执行。
  验证方式：在orElseThrow这行单独打线程挂起的断点，单步执行代码，如果执行完该行直接跳到上层的catch块，即可确认是该问题。

• Optional类导入错误
  检查代码顶部的import语句，确认使用的是JDK原生的java.util.Optional。Guava、Vavr、Spring内部工具类、旧版Android SDK中都存在同名的Optional类，部分第三方实现的空判断逻辑和JDK原生存在差异，低版本甚至存在逻辑bug。

• Spring Data JPA版本缺陷
  2.0.0.M1之前的Spring Data JPA存在已知bug：自定义查询返回null时，会错误调用Optional.of(null)（而非Optional.ofNullable(null)）包装结果，这行代码执行时就会直接抛出NullPointerException，根本不会走到后续的orElseThrow逻辑；部分旧版本Hibernate结合懒加载查询时，还可能返回持有null代理的非标准Optional对象，导致isPresent()判断结果和实际取值逻辑不一致。
  解决方式：升级Spring Data JPA到2.0及以上正式版本，自定义Repository方法返回结果时手动用Optional.ofNullable()做一层包装。

• 运行字节码和源码不匹配
  如果使用了Spring DevTools热部署、IDE增量编译缓存未清，可能出现运行的字节码和当前编辑的源码不一致的情况——比如旧版本代码中该行实际写的是orElse(null)，自然不会抛出异常。
  验证方式：执行全量清理编译命令，重启应用后再测试。

• 编译器bug
  Eclipse JDT的ecj编译器4.7以下版本，对带泛型限定的方法引用存在字节码生成缺陷，可能导致异常供应函数没有被正确调用。可以切换到JDK自带的javac编译器编译验证。

内容的提问来源于stack exchange，提问作者Jurgen Rutten