升级Eclipse 2023-09后@Nullable注解无法应用问题咨询

问题描述 #

升级Eclipse到2023-09版本后，在编写带泛型的方法时，将JSR305的javax.annotation.Nullable注解放在泛型声明<T>之后、返回类型Set<T>之前时，会触发错误提示：

未指定显式目标元素类型的注解类型无法在此处应用。

报错代码示例：

public <T> @Nullable Set<T> getSomeSet(T something) {
  // ...
}

以下场景不会出现该错误：

• 使用Eclipse 2022-09及更早版本
• 使用IntelliJ IDEA编译
• 通过gradlew compileJava编译
• 方法返回类型为通配符泛型（如public @Nullable Set<?> getSomeSet()）
• 将@Nullable放在泛型声明之前（如public @Nullable <T> Set<T> getSomeSet(T something)）

问题原因 #

Eclipse 2023-09对注解的目标元素检查做了严格化处理。JSR305的@Nullable注解默认的@Target范围是METHOD、PARAMETER、FIELD，并不包含TYPE_USE（用于注解类型本身，比如泛型、返回类型的组成部分）。

当把@Nullable放在<T>之后、Set<T>之前时，Eclipse会判定你试图注解泛型类型参数的边界或返回类型的泛型组成部分，但@Nullable并不支持这类目标，因此抛出错误。而旧版Eclipse、IntelliJ或javac会将这个位置的注解默认解析为对方法返回值的注解，所以不会报错。

解决办法 #

1. 调整注解位置（推荐） #

将@Nullable移到泛型声明<T>之前，让Eclipse明确识别这是对方法返回值的注解，写法如下：

public @Nullable <T> Set<T> getSomeSet(T something) {
  // ...
}

这种写法符合Java注解规范，且在所有环境下都能正常编译。

2. 替换为支持TYPE_USE的@Nullable注解 #

如果不想调整代码结构，可以替换为支持TYPE_USE目标的@Nullable注解，比如Checker Framework的org.checkerframework.checker.nullness.qual.Nullable，或者Guava提供的com.google.common.annotations.Nullable（需确认其@Target包含TYPE_USE）。这类注解可以合法地放在返回类型之前的位置。

3. 调整Eclipse编译器警告级别 #

如果必须保留原有代码结构，可以尝试调整Eclipse的编译器设置：

• 打开Window > Preferences > Java > Compiler > Errors/Warnings
• 展开Annotations分类，找到Annotation is not applicable to target选项
• 将其从Error改为Warning或Ignore

不过这种方式会放宽所有注解的目标检查，可能掩盖其他潜在问题，不推荐作为长期解决方案。

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