JPMS模块化下Maven中Mockito无法访问私有成员问题求助

我来帮你搞定这个Java 11+JPMS迁移后遇到的Mockito测试坑。先理清楚核心问题：你的测试在Eclipse里能正常跑，但Maven执行时就报错Mockito无法反射访问测试类的私有@Mock字段，这本质是JPMS的模块封装机制在起作用。

问题原因分析 #

JPMS（Java平台模块系统）默认会严格限制外部模块对模块内私有成员的反射访问。Eclipse的测试运行环境可能自动帮你添加了模块访问权限，但Maven的Surefire插件默认没有处理这种场景，导致Mockito无法通过反射初始化你的私有@Mock字段。

具体解决方案 #

这里有几个可行的方案，你可以根据项目实际情况选择：

1. 在module-info.java中显式开放模块权限 #

直接在主模块（或测试模块）的module-info.java里，把测试类所在的包开放给Mockito和JUnit相关模块，允许它们进行反射访问：

module foo.bar {
    // 主代码依赖的模块声明...
    
    // 开放测试类所在包给Mockito和JUnit组件
    opens foo.bar to org.mockito, org.junit.platform.commons, org.junit.jupiter.api;
}

如果你的测试代码在单独的测试模块（比如foo.bar.test），调整测试模块的module-info.java即可。

2. 配置Maven Surefire插件添加JVM参数 #

如果不想修改module-info.java，可以通过Surefire插件的argLine参数强制添加模块开放的JVM参数：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M5</version>
            <configuration>
                <argLine>
                    --add-opens foo.bar/foo.bar=org.mockito
                    --add-opens foo.bar/foo.bar=org.junit.platform.commons
                </argLine>
            </configuration>
        </plugin>
    </plugins>
</build>

记得把foo.bar替换成你实际的模块名和包名。

3. 升级Mockito和Surefire版本 #

你当前用的Mockito 3.5.10版本比较旧，对JPMS的支持不够完善。升级到最新稳定版的Mockito（比如4.x或5.x系列），同时搭配更新的Surefire插件版本，能更好地适配JPMS环境：

<!-- 升级Mockito依赖 -->
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>4.11.0</version>
    <scope>test</scope>
</dependency>

<!-- 升级Surefire插件 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M7</version>
</plugin>

为什么Eclipse能正常运行？ #

Eclipse的测试运行器（比如JUnit 5插件）默认会为测试场景添加必要的--add-opens参数，或者在模块处理上更宽松，所以不需要额外配置就能跑通测试。而Maven的Surefire插件需要显式配置才能绕过JPMS的封装限制。

选一个方案调整后，运行mvn test应该就能解决这个反射访问的问题了。

内容的提问来源于stack exchange，提问作者oscar.haglund