Error-Prone 项目在 JDK 模块化环境下遇到的 IllegalAccessError 问题解析

问题背景

在使用 Error-Prone 静态代码分析工具时，开发者可能会遇到一个典型的模块化系统访问权限问题。具体表现为编译过程中抛出 IllegalAccessError 异常，提示无法访问 JavacProcessingEnvironment 类。这是由于 Java 9 引入的模块化系统对内部 API 访问进行了更严格的限制所导致的。

错误现象

当使用 Error-Prone 2.26.1 版本时，编译过程中会出现以下关键错误信息：

java.lang.IllegalAccessError: class com.google.errorprone.ErrorPronePlugins 
cannot access class com.sun.tools.javac.processing.JavacProcessingEnvironment 
because module jdk.compiler does not export com.sun.tools.javac.processing to unnamed module

这表明 Error-Prone 插件尝试访问 JDK 编译器模块中的内部 API，但由于模块系统限制而失败。

根本原因

Java 9 引入的模块化系统(Jigsaw)对内部 API 的访问进行了严格控制。Error-Prone 作为静态分析工具需要访问 javac 的内部处理环境(JavacProcessingEnvironment)，但默认情况下这些 API 不再对未命名模块(即传统的类路径上的代码)开放。

解决方案

对于 Gradle 用户

推荐使用专门的 Gradle 插件来集成 Error-Prone，该插件会自动处理所需的模块系统配置。最新版本的插件会自动添加必要的 JVM 参数：

--add-exports=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED

这个参数明确告诉 JVM 将指定包导出给所有未命名模块，从而允许 Error-Prone 访问所需的内部 API。

手动配置方案

如果无法使用 Gradle 插件，则需要手动确保编译任务配置了上述 JVM 参数。这可以通过以下方式实现：

1. 在构建脚本中明确添加编译器参数
2. 确保使用的 Java 版本与 Error-Prone 兼容
3. 验证所有相关依赖的版本一致性

最佳实践建议

1. 保持工具链更新：始终使用 Error-Prone 和配套插件的最新稳定版本
2. 模块系统认知：了解项目使用的 Java 版本是否启用了模块化特性
3. 构建工具集成：优先使用官方推荐的构建工具插件而非手动配置
4. 环境验证：在 CI/CD 流程中加入对 Java 版本和模块配置的验证步骤

技术深度解析

Java 模块化系统引入后，传统的反射式访问和内部 API 使用方式受到了严格限制。Error-Prone 这类深度集成到编译过程的工具需要特殊权限来访问编译器内部状态。--add-exports 参数实际上是模块系统的一个逃生舱口，允许在必要情况下突破这些限制，但应该谨慎使用。

理解这一机制不仅有助于解决 Error-Prone 的集成问题，也为处理其他类似工具（如 Lombok 或注解处理器）的兼容性问题提供了思路框架。在模块化成为 Java 生态主流趋势的背景下，这类问题的解决模式值得开发者掌握。