如何解决IDEA对数组的空值检查异常问题？

我在package-info.java中配置了默认非空检查：

@DefaultNonNull // 表示所有参数和变量默认非空

IDEA的空值检查功能运行正常，仅数组场景例外。例如在数组声明中：

@Nullable String @Nullable [] arr = new String[]{"a", "b", "c", null};

尽管我已将数组本身及其元素都标记为可空，IDEA仍提示错误：

'null' is stored to an array of @NotNull elements

IDEA版本信息 #

IntelliJ IDEA 2025.1 (Community Edition)
Build #IC-251.23774.435, built on April 14, 2025
Source revision: 9b2a2c261c093
Runtime version: 21.0.6+9-b895.109 amd64 (JCEF 122.1.9)
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
Toolkit: sun.awt.windows.WToolkit
Windows 10.0
Kotlin plugin: K2 mode
GC: G1 Young Generation, G1 Concurrent GC, G1 Old Generation
Memory: 2048M
Cores: 16
Registry:
  ide.experimental.ui=true
  llm.show.ai.promotion.window.on.start=false
  terminal.new.ui=true
Non-Bundled Plugins:
  de.kontext_e.idea.plugins.jqa (2.0)
  Lombook Plugin (251.23774.460)
  org.jetbrains.plugins.github (251.23774.435-IU)
  com.alibabacloud.intellij.cosy (2.3.0)
Kotlin: 251.23774.435-IJ

自定义注解代码 #

DefaultNonNull注解 #

import javax.annotation.Nonnull;
import javax.annotation.meta.TypeQualifierDefault;
import javax.annotation.meta.TypeQualifierNickname;
import javax.annotation.meta.When;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Nonnull(when = When.ALWAYS)
@TypeQualifierNickname
@Target({
    ElementType.TYPE,
    ElementType.METHOD,
    ElementType.CONSTRUCTOR,
    ElementType.PACKAGE,
})
@TypeQualifierDefault({
    ElementType.METHOD,
    ElementType.FIELD,
    ElementType.PARAMETER,
    ElementType.LOCAL_VARIABLE,
    ElementType.TYPE_PARAMETER,
    ElementType.TYPE_USE,
})
public @interface DefaultNonNull {
}

Nullable注解 #

import javax.annotation.Nonnull;
import javax.annotation.meta.TypeQualifierNickname;
import javax.annotation.meta.When;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Nonnull(
    when = When.MAYBE
)
@Retention(RetentionPolicy.RUNTIME)
@TypeQualifierNickname
@Target({
    ElementType.METHOD,
    ElementType.FIELD,
    ElementType.PARAMETER,
    ElementType.LOCAL_VARIABLE,
    ElementType.TYPE_USE,
})
public @interface Nullable {
}

使用的JSR305依赖：com.google.code.findbugs:jsr305:3.0.2

解决方法 #

1. 配置IDEA识别自定义注解
   打开IDEA设置：File → Settings → Editor → Inspections → Java → Probable bugs → Nullability issues，在右侧的「Nullability annotations」区域，将自定义的@Nullable添加到「Nullable annotations」列表，@DefaultNonNull添加到「Default not null annotations」列表，确保IDEA能正确识别这些注解的空值语义。

2. 调整数组注解写法
   Java数组的类型注解写法有多种，尝试简化写法：

   • 如果仅需要数组元素可空：

     String @Nullable [] arr = new String[]{"a", "b", "c", null};
     

   • 如果数组本身和元素都可空：

     @Nullable String[] arr = new String[]{"a", "b", "c", null};
     

   部分IDE对双重@Nullable的写法解析存在兼容问题，简化后可能解决提示错误。

3. 验证注解兼容性
   临时替换为IDEA原生的org.jetbrains.annotations.Nullable和org.jetbrains.annotations.NotNull进行测试，如果问题消失，说明自定义注解的配置存在兼容性问题，需要检查@TypeQualifierNickname等元注解的使用是否符合IDEA的解析规则。

4. 排查插件冲突
   暂时禁用Lombok等非必要插件，重启IDEA后测试空值检查是否正常，排除插件干扰的可能。

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