@ParametersAreNonnullByDefault注解未生效：类参数未触发空指针检查

你遇到的问题其实是对这个注解的作用理解有偏差——它本身不会自动在运行时执行空参数检查，下面给你详细拆解：

• 这个注解的本质是编译时标记注解，属于javax.annotation（现已迁移到jakarta.annotation）包，它的核心作用是给静态代码分析工具（比如SpotBugs、FindBugs，或者IntelliJ IDEA、Eclipse的内置代码检查器）提供规则提示：告诉工具“这个类/包下的所有方法参数默认都不应该传入null”。

• 运行时层面，JVM完全不识别这个注解，不会为你自动插入Objects.requireNonNull()这类空检查逻辑。所以你传入null时，代码会正常执行，不会抛出NullPointerException——这是预期行为，因为注解本身没有运行时的强制执行能力。

• 要实现你预期的“传null就抛NPE”的效果，你需要手动添加空检查逻辑，比如在构造方法和方法里显式调用：

  public MyClass(Integer intField) {
      this.intField = Objects.requireNonNull(intField, "intField cannot be null");
  }
  
  public Integer someMethod(Integer a) {
      Objects.requireNonNull(a, "a cannot be null");
      return a;
  }
  

  或者可以配合其他工具注解，比如Lombok的@NonNull——它会在编译阶段自动帮你生成空检查代码，运行时就能抛出NPE。

• 那这个注解的实际价值在哪里？它能让静态分析工具在你编写代码或者编译时就给出警告：比如你在IDE里写new MyClass(null)，开启相关检查后，IDE会直接标红提示你“这个参数不应该为null”；用SpotBugs扫描代码时，也会把这类传null的行为标记为潜在bug，帮你提前发现问题，而不是等到运行时才暴露。

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