Lombok @NonNull注解与直接抛NPE的区别及空检查意义探讨

先看两个核心代码示例：

示例1：使用Lombok @NonNull注解 #

public void test(@NonNull String input){ 
    // #1
    log(input.length()); 
}

示例2：手动显式空检查 #

public void test(String input){ 
    if(input == null){ 
        throw new NullPointerException(); 
    } 
    log(input.length()); 
}

问题1：使用@NonNull注解与让NPE在#1行抛出有何区别？ #

两者的核心差异体现在错误定位、代码可读性与约束声明上：

• 异常清晰度与定位效率：Lombok的@NonNull会在方法入口处直接校验参数，传入null时立刻抛出带明确指向的NPE（默认提示如"input is marked non-null but is null"），错误栈直接指向参数问题，一眼就能定位到是哪个参数违规；而让NPE在#1行抛出时，错误栈会指向input.length()这一行，你需要额外反应一步才能关联到input为null的根源，复杂方法里这个定位成本会更高。
• 代码简洁性：如果方法有多个非空参数，@NonNull只需在参数上标注即可，省去了大量重复的if (xxx == null)样板代码；手动检查则要写一堆冗余判断，代码会显得臃肿。
• 声明式约束与IDE支持：@NonNull是一种直观的文档式约束，其他开发者看方法签名就知道参数不能为null，无需阅读方法内部逻辑；而且主流IDE会识别该注解，调用方法时传入可能为null的变量会直接给出警告，提前规避潜在问题——手动空检查没有这个IDE提示能力。

问题2：显式空检查是否有意义？直接不做空检查让NPE抛出是否更优？Lombok @NonNull为何存在？ #

这个问题需要分场景讨论：

• 显式空检查的价值：如果需要自定义异常信息（比如抛出带业务上下文的提示，或者替换为IllegalArgumentException而非NPE），或者要在抛异常前做额外操作（比如记录特定日志、终止后续可能产生副作用的逻辑），显式空检查就很有必要。另外，在复杂方法里，提前校验参数能避免后续执行到一半出错，减少无效的资源消耗（比如避免无用的数据库查询、远程调用）。
• 直接不做空检查的场景：如果方法逻辑非常简单，比如只是调用参数的某个方法，NPE的原因一目了然，这时候不做检查也能接受，但缺点是错误信息不够直观，定位问题的速度会慢一点。
• Lombok @NonNull存在的核心意义：它完美平衡了简洁性与严谨性——既省去了写重复空检查的样板代码，又能在方法入口处抛出清晰的异常，同时自带文档属性和IDE提示能力。相当于把手动空检查的逻辑自动化，同时提升了代码的可读性和可维护性，这也是它被广泛使用的原因。

内容的提问来源于stack exchange，提问作者Cyriac George