Checker Framework编译报错：java.lang.NoSuchFieldError: RELEASE

你碰到的是Checker Framework版本与JDK 8不兼容的典型问题——从异常栈里的org.checkerframework.javacutil.PluginUtil.getReleaseValue调用可以看出，这个方法尝试访问JDK 9及以上才有的com.sun.tools.javac.main.Main.RELEASE字段，而JDK 8的javac中根本不存在这个字段，因此抛出了NoSuchFieldError。

问题根源 #

较新版本的Checker Framework（比如3.20.0及以后）已经正式停止支持JDK 8，它们的代码依赖了JDK 9引入的javac API特性，而你的环境基于JDK 1.8，自然会出现这个兼容性错误。

可行解决方案 #

你有两个明确的解决方向：

1. 降级Checker Framework到支持JDK 8的版本

这是最直接且无需改动JDK环境的方案。在你的pom.xml中，将Checker Framework的依赖版本改为3.19.0（这是最后一个稳定支持JDK 8的版本）：

<!-- Checker Framework 注解依赖 -->
<dependency>
    <groupId>org.checkerframework</groupId>
    <artifactId>checker-qual</artifactId>
    <version>3.19.0</version>
</dependency>
<!-- 注解处理器依赖 -->
<dependency>
    <groupId>org.checkerframework</groupId>
    <artifactId>checker</artifactId>
    <version>3.19.0</version>
    <scope>provided</scope>
</dependency>

同时确保Maven Compiler插件的配置正确绑定JDK 8的编译参数：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.checkerframework</groupId>
                <artifactId>checker</artifactId>
                <version>3.19.0</version>
            </path>
        </annotationProcessorPaths>
        <compilerArgs>
            <arg>-processor</arg>
            <arg>org.checkerframework.checker.nullness.NullnessChecker</arg>
        </compilerArgs>
    </configuration>
</plugin>

修改完成后执行mvn clean install，应该就能正常编译了。

2. 升级JDK到9及以上版本

如果你的项目允许调整JDK版本，可以把环境切换到JDK 9或更高版本，此时RELEASE字段会存在于javac的API中，Checker Framework的新版本也能正常工作。不过这个方案需要评估项目其他依赖的兼容性，避免引入新的问题。

验证步骤 #

1. 先执行mvn clean清理之前的构建缓存，避免旧依赖干扰
2. 运行mvn install重新构建项目
3. 如果仍有问题，可以检查Maven依赖树，确保没有意外引入高版本的Checker Framework：

mvn dependency:tree | grep checkerframework

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