Maven 3.6.2中test-jar runtime自引用报错及优化方案求助

首先明确：这不是Maven的bug，而是Maven 3.5.x及以后版本中引入的循环依赖检查增强特性。旧版本（如3.3.9）对自依赖的检查只针对同类型的构件（比如jar依赖jar），但新版本扩展了检查范围，只要是项目自身的依赖（无论type是jar还是test-jar，也不管scope是什么），都会被判定为循环依赖并阻止构建——Maven团队认为这种自引用会带来构建逻辑的不确定性，即使你的场景看起来合理。

接下来给你几个无需新增独立制品的替代方案，都能满足“开发时可用mock类、生产环境不打包”的需求：

方案一：用maven-dependency-plugin解压test-jar中的mock类 #

这个方案最贴近你原来的思路，只是把“依赖test-jar”改成“主动解压test-jar里的mock类到运行时类路径”：

在你的mocking profile中添加如下配置：

<profile>
  <id>mocking</id>
  <activation>
    <activeByDefault>false</activeByDefault>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <executions>
          <execution>
            <id>unpack-mock-classes</id>
            <phase>process-classes</phase>
            <goals>
              <goal>unpack</goal>
            </goals>
            <configuration>
              <artifactItems>
                <artifactItem>
                  <groupId>${project.groupId}</groupId>
                  <artifactId>${project.artifactId}</artifactId>
                  <version>${project.version}</version>
                  <type>test-jar</type>
                  <!-- 只解压mock类所在的包，避免把JUnit测试类也引入 -->
                  <includes>com/myproject/mocks/**/*.class</includes>
                </artifactItem>
              </artifactItems>
              <!-- 把mock类放到主项目的输出目录，运行时就能加载到 -->
              <outputDirectory>${project.build.outputDirectory}</outputDirectory>
            </configuration>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</profile>

• 激活mocking profile时，Maven会在process-classes阶段把test-jar里的mock类解压到target/classes，运行时就能正常加载。
• 生产环境不激活该profile，这个步骤不会执行，mock类也就不会被打包到war中。

方案二：将mock类移到主源码目录，用profile控制编译范围 #

这个方案更符合Maven的规范，把mock类放在main/java下，通过profile控制是否编译它们：

1. 把mock类从test/java移到main/java/com/myproject/mocks（保持包结构）。
2. 在主build块中默认排除mock类的编译：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
        <excludes>
          <exclude>com/myproject/mocks/**/*.java</exclude>
        </excludes>
      </configuration>
    </plugin>
  </plugins>
</build>

3. 在mocking profile中取消排除，编译mock类：

<profile>
  <id>mocking</id>
  <activation>
    <activeByDefault>false</activeByDefault>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <!-- 清空默认排除规则 -->
          <excludes/>
          <!-- 明确包含mock类 -->
          <includes>
            <include>com/myproject/mocks/**/*.java</include>
          </includes>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

• 平时开发激活mocking profile，mock类会被编译到target/classes，运行时可用。
• 生产打包不激活该profile，mock类不会被编译，自然不会出现在最终的war包里。

方案三：IDE中直接添加test-classes到运行类路径（仅开发阶段） #

如果你的场景只是开发时在IDE中运行项目需要mock类，也可以不用修改Maven配置，直接在IDE（比如IntelliJ IDEA/Eclipse）中：

• 激活mocking profile后，把项目的target/test-classes目录添加到运行配置的类路径中（设置为runtime scope）。
• 这种方式不需要修改pom，但只能在IDE中生效，适合本地开发调试的场景。

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