如何在 Maven 中正确配置 JVM 参数以解决 JDK 17 模块访问异常-java教程-PHP中文网

如何在 Maven 中正确配置 JVM 参数以解决 JDK 17 模块访问异常

JDK 17 引入严格的模块封装机制，导致测试运行时出现 InaccessibleObjectException；需通过 Maven Surefire 和 Compiler 插件协同配置 --add-opens 参数，确保 JVM 启动参数被正确传递至测试进程。

jdk 17 引入严格的模块封装机制，导致测试运行时出现 `inaccessibleobjectexception`；需通过 maven surefire 和 compiler 插件协同配置 `--add-opens` 参数，确保 jvm 启动参数被正确传递至测试进程。

当从旧版 JDK 升级至 JDK 17 时，Java 运行时默认禁止反射访问核心模块（如 java.base）中的非公开成员。典型错误如：

java.lang.reflect.InaccessibleObjectException: 
Unable to make protected native java.lang.Object java.lang.Object.clone() 
accessible: module java.base does not "opens java.lang" to unnamed module

该异常在 IDE（如 IntelliJ）中可通过测试运行配置添加 VM 选项临时规避，但在 Maven 构建中若仅在 <argline></argline> 中声明却未生效，往往是因为 参数未被正确解析、插件版本兼容性问题，或缺少编译阶段的对应配置。

✅ 正确配置方式（Surefire + Compiler 双保障）

1. Surefire 插件：确保测试 JVM 启动时加载开放指令

必须将所有 --add-opens 参数完整写入 <argline></argline>，且每行一个参数或使用空格分隔的字符串（推荐多行格式提升可读性与可维护性）。注意：<argline></argline> 是 字符串值，Maven 不会自动拆分空格为独立参数，因此务必保证语法严格正确：

<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-surefire-plugin</artifactid><version>3.1.2</version><configuration><skiptests>${skip.surefire.integration.tests}</skiptests><forkcount>10</forkcount><reuseforks>false</reuseforks><argline>
      --add-opens java.base/java.lang=ALL-UNNAMED
      --add-opens java.base/java.lang.reflect=ALL-UNNAMED
      --add-opens java.base/java.util.concurrent=ALL-UNNAMED
      --add-opens java.base/java.util=ALL-UNNAMED
    </argline></configuration></plugin>

⚠️ 注意事项：

<includes></includes> 默认即匹配 **/*Test.java，无需显式声明，冗余配置可能干扰默认行为；

若使用 <forkmode></forkmode> 或 <usesystemclassloader></usesystemclassloader> 等过时配置，请升级至 forkCount + reuseForks 组合（本例已正确使用）；

argLine 内容会被原样传递给 java 命令，因此换行符会被忽略（Maven 自动合并），但建议保持清晰缩进便于维护。

2. Compiler 插件：确保编译期兼容性（关键补充）

JDK 17 的模块限制同样影响编译过程（尤其涉及 --add-opens 的注解处理器或内省逻辑）。应在 maven-compiler-plugin 中通过 <compilerargs></compilerargs> 显式传入相同参数：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target><compilerargs><arg>--add-opens</arg><arg>java.base/java.lang=ALL-UNNAMED</arg><arg>--add-opens</arg><arg>java.base/java.lang.reflect=ALL-UNNAMED</arg><arg>--add-opens</arg><arg>java.base/java.util.concurrent=ALL-UNNAMED</arg><arg>--add-opens</arg><arg>java.base/java.util=ALL-UNNAMED</arg></compilerargs></configuration></plugin>

? 提示：<compilerargs></compilerargs> 中每个 <arg></arg> 标签代表一个独立命令行参数，因此必须成对出现（--add-opens + 其目标值），不可合并为单个字符串。

3. 验证与调试技巧

执行 mvn clean test -X 查看 Surefire 插件日志，搜索 Running with Java version 和 argLine = 确认参数是否被读取；
若仍失败，尝试临时降低 forkCount 至 1 并设置 <debug>true</debug>，便于附加调试器定位真实执行环境；
推荐同步检查依赖项是否支持 JDK 17（如 JUnit 5.8+、Mockito 4.0+），避免因框架自身反射滥用引发同类异常。