Maven跨项目测试类依赖问题：tddl-matrix找不到tddl-rule测试类

这是个典型的Maven多模块构建中测试类跨模块依赖的问题，两台机器的差异核心源于构建上下文和本地环境的不同，具体原因拆解如下：

1. 构建方式的差异（最可能的核心原因） #

你提到本地仓库里没有TestUtils类，只存在于tddl-rule的target目录——这说明成功编译的机器，大概率是在父项目根目录下执行的mvn install -DskipTests命令：

• 当在多模块父项目中执行Maven命令时，Maven Reactor会按照模块依赖顺序自动构建（先构建tddl-rule，再构建tddl-matrix）。
• 构建过程中，tddl-matrix编译测试代码时，会自动将tddl-rule的target/test-classes目录加入到编译路径中，因此能找到TestUtils类。
• 而报错的机器，应该是单独在tddl-matrix的目录下执行的构建命令：此时Maven只能从本地仓库获取tddl-rule的jar包，但默认Maven的jar包不会包含测试类（TestUtils属于测试目录代码），所以编译测试代码时找不到该类。

2. 本地环境残留的差异 #

成功的机器可能之前有过以下操作，导致测试类路径被临时注入：

• 用IDEA/Eclipse等IDE构建过整个项目，IDE会自动把所有模块的测试类路径加入到全局编译路径中，后续Maven命令行执行时复用了这个缓存。
• 之前执行过tddl-rule的mvn install且没有跳过测试（或手动把测试类打包到了本地仓库的jar中），但这种情况概率较低，因为默认Maven不会将测试类打包进主jar。

3. Maven配置的细微差异 #

两台机器的Maven settings.xml配置可能存在差异，比如某台机器配置了本地仓库的快照缓存策略，或者启用了某些插件扩展，导致测试类路径被额外加载，但这种情况属于小众场景。

解决方案：规范跨模块测试类依赖 #

要彻底解决这个不一致问题，需要按照Maven的规范来处理跨模块测试类依赖：

1. 在tddl-rule的POM中配置生成测试jar：
   添加maven-jar-plugin的配置，将测试类打包成独立的test-jar：

   <build>
     <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-jar-plugin</artifactId>
         <executions>
           <execution>
             <goals>
               <goal>test-jar</goal>
             </goals>
           </execution>
         </executions>
       </plugin>
     </plugins>
   </build>
   

2. 在tddl-matrix的POM中添加test-jar依赖：
   明确引入tddl-rule的测试jar，scope设置为test，确保只有测试代码能访问：

   <dependencies>
     <!-- 其他依赖 -->
     <dependency>
       <groupId>${project.groupId}</groupId>
       <artifactId>tddl-rule</artifactId>
       <version>${project.version}</version>
       <type>test-jar</type>
       <scope>test</scope>
     </dependency>
   </dependencies>
   

3. 统一构建流程：后续所有构建都在父项目根目录下执行mvn install -DskipTests，确保模块间依赖的一致性。

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