Java中如何像Lombok@NonNull那样避免函数返回对象空检查？有无更佳实践？

嘿，这个问题问到点子上了——相信不少Java开发者都烦透了到处写if (obj != null)的样板代码。咱们一步步来聊清楚：

有没有类似Lombok @NonNull的返回值注解？ #

首先明确：Lombok的@NonNull主要是给方法/构造器参数用的，编译期会自动生成参数非空检查的代码，强制调用方不能传null。但它没有直接针对返回值的等价注解——毕竟返回值的null逻辑往往和业务强绑定（比如你要抛特定的UserNotFoundException，而不是通用的NPE），没法用一个注解统一处理。

不过倒是有一些工具/框架的注解能帮你做静态检查：

• Spring的@NonNull（方法返回值上）或者全局的@NonNullApi：配合Spring的静态代码扫描，IDE会给你提示“这个方法可能返回null”，但不会自动生成运行时的异常抛出逻辑。
• JetBrains的@NotNull（IntelliJ自带）：也是静态检查层面的提示，帮你提前发现潜在的NPE风险，但同样不会自动处理业务异常。

这些注解更多是“提示”，没法替代你示例里的手动空检查+异常抛出逻辑。

更好的空检查实践方案 #

接下来聊聊真正能减少样板代码、更优雅的方案：

1. 用Java 8+的Optional（最推荐的标准方案） #

Optional就是Java官方为了解决null问题设计的，它的核心是显式标记可能为空的值，强迫你去处理空值场景，避免隐式的NPE。把你的示例改写成Optional的风格：

如果能修改service.findOne(id)的返回值类型为Optional<User>（从源头就明确可能为空）：

Optional<User> userOpt = service.findOne(id);
return userOpt.orElseThrow(() -> new UserNotFoundException("Invalid ID - " + id));

如果暂时没法修改service的返回值，也可以手动包装：

User user = service.findOne(id);
return Optional.ofNullable(user)
               .orElseThrow(() -> new UserNotFoundException("Invalid ID - " + id));

这种写法语义清晰，一眼就能看出来“如果为空就抛这个异常”，而且编译器会提醒你不要忽略空值情况，避免漏写检查。

2. 用工具类封装自定义检查逻辑 #

如果你不想用Optional，也可以用成熟的工具类或者自己封装方法来减少重复代码：

• Apache Commons Lang的Validate.notNull()：

User user = service.findOne(id);
Validate.notNull(user, "Invalid ID - %d", id);
return user;

不过这个会抛出IllegalArgumentException，如果需要抛你自定义的UserNotFoundException，可以自己写个简单的工具方法：

// 自定义工具类
public class Preconditions {
    public static <T> T requireNonNullElseThrow(T obj, Supplier<? extends RuntimeException> exceptionSupplier) {
        if (obj == null) {
            throw exceptionSupplier.get();
        }
        return obj;
    }
}

// 使用时一行搞定
return Preconditions.requireNonNullElseThrow(service.findOne(id), 
    () -> new UserNotFoundException("Invalid ID - " + id));

• Guava的Preconditions.checkNotNull()：和Apache的类似，默认抛NullPointerException，也可以自定义错误消息。

3. 从源头避免空值：让服务层直接处理异常 #

说白了，如果findOne(id)找不到用户本身就是业务异常，那最好把空检查+抛异常的逻辑封装到service层，上层调用代码完全不用关心空值：

// Service层代码
public User findOne(Long id) {
    User user = // 从数据库/其他数据源查询
    if (user == null) {
        throw new UserNotFoundException("Invalid ID - " + id);
    }
    return user;
}

// 上层调用代码（直接用，不用任何检查）
User user = service.findOne(id);
return user;

这是最干净的方案——符合单一职责原则，把空值处理的逻辑放在最适合的地方，上层代码只需要专注自己的业务逻辑。

总结 #

• 没有和Lombok @NonNull完全等价的返回值注解（能自动生成业务相关异常），但有静态检查注解帮你提前发现风险；
• 优先推荐用Optional，它是Java标准库的一部分，语义清晰，能有效避免隐式NPE；
• 次选是用工具类或自定义方法封装检查逻辑，减少样板代码；
• 最理想的是从服务层源头处理空值，上层调用无需检查。

内容的提问来源于stack exchange，提问作者Mohamed Abdallah