Maven编译泛型参数中@Nonnull注解报错Eclipse正常问题咨询

问题原因分析 #

1. 写法不符合Java官方规范 #

你使用的com.google.code.findbugs:jsr305库中的@javax.annotation.Nonnull注解本身的元注解@Target没有包含TYPE_USE，仅支持作用在方法、字段、参数、局部变量等位置，直接标注在泛型类型参数上（List<@Nonnull String>）属于非法的注解位置，OpenJDK的javac编译器会严格校验该规则，因此Maven构建直接报错。

2. Eclipse可正常编译的原因 #

Eclipse默认使用自研的JDT编译器而非标准javac，你在配置中开启了空值分析后，JDT对jsr305的空注解做了扩展兼容：不会严格校验注解的@Target范围，允许将@Nonnull用在类型位置做空值校验，因此可以正常编译通过。

合理解决方案 #

方案1：更换支持TYPE_USE的空注解库（最推荐） #

直接替换为Eclipse官方的空注解库，该库的@NonNull注解原生包含TYPE_USE目标，完美兼容你现有的Eclipse空值分析配置，同时符合Java规范，javac编译不会报错：

1. 替换pom依赖：

<dependency>
    <groupId>org.eclipse.jdt</groupId>
    <artifactId>org.eclipse.jdt.annotation</artifactId>
    <version>2.2.600</version>
</dependency>

2. 将代码中的import javax.annotation.Nonnull;替换为import org.eclipse.jdt.annotation.NonNull;
3. 调整Eclipse空分析配置中的非空注解指向为org.eclipse.jdt.annotation.NonNull即可，原有List<@NonNull T>的写法完全不需要改动。

方案2：使用非空默认注解 #

如果不想更换依赖，可以在类或包上添加@javax.annotation.ParametersAreNonnullByDefault注解，该注解作用范围内的所有方法参数、集合元素默认被Eclipse识别为非空，不需要在泛型参数位置单独标注@Nonnull，既满足空校验需求，也不会触发编译错误。

方案3：Maven配置使用JDT编译器 #

如果不想改动现有代码，可以直接让Maven使用和Eclipse一致的JDT编译器进行构建，完全对齐Eclipse的编译行为：

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <compilerId>jdt</compilerId>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.eclipse.tycho</groupId>
            <artifactId>tycho-compiler-jdt</artifactId>
            <version>3.0.0</version>
        </dependency>
    </dependencies>
</plugin>

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