Maven Compiler Plugin编译测试代码依赖处理差异问题求助

一、为什么生产编译和测试编译的模块路径处理不同？ #

Maven Compiler Plugin对生产代码和测试代码的依赖处理逻辑差异，本质是JPMS规范与测试场景需求的平衡：

• 生产代码编译（compile目标）：严格遵循JPMS的依赖解析规则，仅将主模块module-info.java中显式requires的直接依赖加入模块路径（module path），其余依赖（包括传递依赖）自动放入类路径（class path）。这是因为生产模块的依赖关系由模块描述符明确定义，不需要将未直接依赖的jar纳入模块化系统。
• 测试代码编译（testCompile目标）：默认行为是将**所有测试范围的依赖（主代码的全量依赖+测试自身的直接/传递依赖）**都加入模块路径。早期插件设计是为了避免测试代码出现类找不到的问题，但这种“一刀切”的方式会把大量未做好模块化的依赖（比如存在拆分包的老库）带入模块系统，而JPMS严格禁止同一模块路径下出现多个jar包含相同包的情况，这就是你遇到拆分包错误的根源。

二、如何让testCompile像compile一样解析模块路径？ #

核心思路是手动控制测试编译时的模块路径，只将测试模块module-info.java中显式requires的依赖加入module path，其余依赖留在class path。以下是两种可靠实现方式：

方式1：通过maven-dependency-plugin复制指定依赖，再配置compiler-plugin引用 #

这种方式能精确控制哪些依赖进入模块路径，灵活且易维护。

1. 添加maven-dependency-plugin配置，复制测试模块需要的依赖到指定目录：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.1</version>
    <executions>
        <execution>
            <id>copy-test-module-deps</id>
            <phase>process-test-resources</phase>
            <goals>
                <goal>copy</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/test-module-deps</outputDirectory>
                <!-- 只复制测试module.info中requires的依赖 -->
                <includeGroupIds>io.swagger.parser.v3,com.fasterxml.jackson.core,com.fasterxml.jackson.dataformat,org.junit.jupiter,org.assertj</includeGroupIds>
                <includeArtifactIds>swagger-parser,jackson-databind,jackson-annotations,jackson-dataformat-yaml,junit-jupiter,assertj-core</includeArtifactIds>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 配置maven-compiler-plugin的testCompile目标，使用上述目录作为模块路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.13.0</version>
    <executions>
        <execution>
            <id>default-testCompile</id>
            <goals>
                <goal>testCompile</goal>
            </goals>
            <configuration>
                <modulePath>${project.build.directory}/test-module-deps</modulePath>
                <!-- 其余测试依赖自动留在classpath -->
                <classpathScope>test</classpathScope>
            </configuration>
        </execution>
    </executions>
</plugin>

方式2：通过编译器参数手动指定模块路径 #

如果依赖较少，可以直接在compiler-plugin中通过compilerArgs指定模块路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.13.0</version>
    <configuration>
        <testCompilerArgs>
            <arg>--module-path</arg>
            <!-- 列出测试module.info中requires的所有依赖的路径，用系统分隔符分隔（Windows用;，Linux/macOS用:） -->
            <arg>${settings.localRepository}/io/swagger/parser/v3/swagger-parser/2.1.20/swagger-parser-2.1.20.jar:${settings.localRepository}/com/fasterxml/jackson/core/jackson-databind/2.17.1/jackson-databind-2.17.1.jar:${settings.localRepository}/org/junit/jupiter/junit-jupiter/5.9.0/junit-jupiter-5.9.0.jar</arg>
        </testCompilerArgs>
    </configuration>
</plugin>

注意：这种方式硬编码了依赖路径，灵活性较差，适合依赖固定的小型项目。

三、额外注意事项 #

• 对于存在拆分包的依赖，确保它们被留在classpath中：未命名模块（classpath中的jar）允许拆分包，只要测试代码不直接引用这些拆分包的类，就不会触发JPMS的错误。
• 精简测试模块的module-info.java：只保留实际需要requires的依赖，避免冗余声明，减少需要加入模块路径的依赖数量。
• 验证自动模块名：如果依赖是自动模块（无module-info.java），需确认其MANIFEST.MF中的Automatic-Module-Name属性与你在测试模块中声明的模块名一致，避免依赖解析错误。

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