Oracle OpenJDK 20中com.sun.tools.javac.code包不可见错误的解决方法

问题根源 #

你没显式导入该包，但大概率是依赖的某个库（比如代码生成工具、数据库框架）或Maven插件在底层调用了com.sun.tools.javac.code这个JDK内部API。Java 9+的模块系统默认会封装这类内部包，不允许未命名模块访问，所以触发了这个错误。

具体解决步骤 #

1. 升级依赖与Maven插件 #

打开pom.xml，检查所有数据库相关依赖（如JDBC驱动、ORM框架）和Maven编译插件，把它们升级到支持Java 20的最新版本——旧版本库常依赖JDK内部API，新版本一般会修复这类兼容性问题。
以maven-compiler-plugin为例，确保版本在3.10.1及以上，配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>20</source>
                <target>20</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 添加模块导出参数（强制兼容） #

如果升级依赖后问题仍存在，可通过JVM参数强制让jdk.compiler模块把目标包导出给未命名模块：

• 在IntelliJ的Run/Debug Configurations里，找到你的运行配置，在VM options中添加：

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

• 若用Maven编译，在maven-compiler-plugin配置中加入compilerArgs：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>20</source>
        <target>20</target>
        <compilerArgs>
            <arg>--add-exports</arg>
            <arg>jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED</arg>
        </compilerArgs>
    </configuration>
</plugin>

3. 临时降级JDK版本 #

如果前两种方法都无效，可暂时降级到Java 8（Java 8无模块系统，不会有内部API封装问题），但这只是临时方案，长期来看还是建议升级依赖适配Java 20。

注意 #

com.sun.tools.javac.code属于JDK内部API，官方不推荐任何形式的依赖，这类API随时可能被修改或移除，所以优先选择升级依赖的方式解决问题。

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