如何为Maven项目的test-jar配置正确的传递依赖？

看起来你遇到了Maven中test-jar依赖管理的两个典型问题：一是控制test-jar不依赖对应的主Jar，二是解决跨模块测试依赖的传递性问题。我来一步步帮你解决：

一、让Test-Jar不依赖对应的主Jar #

默认情况下，Maven生成的test-jar是否依赖主Jar，取决于你的测试代码是否引用了主代码里的类：

• 如果测试代码完全没用到主代码，test-jar自然不会包含对主Jar的依赖；
• 如果测试代码引用了主代码，但你不希望test-jar的依赖者自动引入主Jar，可以通过以下方式处理：

1. 确保测试代码无主代码依赖
   这是最根本的方式：如果你的测试工具类/测试代码完全独立于主代码，那么Maven在生成test-jar时，不会自动添加主Jar的依赖。

2. 排除主Jar的传递依赖（如果必须引用主代码）
   如果你不得不引用主代码，但又不想让test-jar的依赖者自动获取主Jar，可以在依赖test-jar的项目中，通过<exclusions>排除主Jar：

   <dependency>
     <groupId>com.example</groupId>
     <artifactId>AAA</artifactId>
     <version>1.0.0</version>
     <type>test-jar</type>
     <scope>test</scope>
     <exclusions>
       <exclusion>
         <groupId>com.example</groupId>
         <artifactId>AAA</artifactId>
       </exclusion>
     </exclusions>
   </dependency>
   

二、解决跨模块测试依赖的传递问题（AAA test-jar -> BBB -> CCC测试找不到类） #

这个问题的核心是：Maven的test范围依赖是不传递的。也就是说，BBB中标记为<scope>test</scope>的AAA test-jar依赖，不会自动传递到CCC的测试类路径中。这里有几种可行的解决方案：

方案1：在CCC中显式依赖AAA的test-jar #

这是最符合Maven依赖设计原则的方案，直接在CCC的pom.xml中添加对AAA test-jar的test范围依赖：

<dependencies>
  <!-- 依赖BBB的test-jar -->
  <dependency>
    <groupId>com.example</groupId>
    <artifactId>BBB</artifactId>
    <version>1.0.0</version>
    <type>test-jar</type>
    <scope>test</scope>
  </dependency>
  <!-- 显式依赖AAA的test-jar -->
  <dependency>
    <groupId>com.example</groupId>
    <artifactId>AAA</artifactId>
    <version>1.0.0</version>
    <type>test-jar</type>
    <scope>test</scope>
  </dependency>
</dependencies>

这种方式清晰明了，保持了测试依赖的隔离性，避免不必要的依赖传递。

方案2：将AAA的test类打包到BBB的test-jar中 #

如果你希望CCC只需要依赖BBB的test-jar就能获取AAA的测试类，可以使用maven-shade-plugin将AAA的test类合并到BBB的test-jar中：

在BBB的pom.xml中添加插件配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <!-- 生成带分类器的shaded test-jar -->
            <shadedArtifactAttached>true</shadedArtifactAttached>
            <shadedClassifierName>test-shaded</shadedClassifierName>
            <!-- 包含AAA的test-jar -->
            <artifactSet>
              <includes>
                <include>com.example:AAA:test-jar</include>
              </includes>
            </artifactSet>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

之后CCC只需依赖BBB的test-shaded分类器Jar即可：

<dependency>
  <groupId>com.example</groupId>
  <artifactId>BBB</artifactId>
  <version>1.0.0</version>
  <classifier>test-shaded</classifier>
  <scope>test</scope>
</dependency>

方案3：调整依赖范围（不推荐） #

你可以将BBB中AAA test-jar的依赖范围从test改为compile，这样依赖会自动传递到CCC。但这种方式会导致AAA的测试类被打包到BBB的主Jar中，破坏了测试代码与生产代码的隔离，除非有特殊需求，否则不建议使用。

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