构建WAR时Maven无法找到tests模块构件的问题求助

问题详情 #

• 迁移背景：老旧Java8代码库迁移至OpenJDK17，多数模块编译完成，某依赖其他模块的WAR模块构建失败
• 错误提示：Could not find artifact com.findology.f2:biz-lib:jar:tests:1.3-SNAPSHOT
• 本地状态：~/.m2/repository中已存在biz-lib-1.3-SNAPSHOT-tests.jar，但Maven无法识别
• 已尝试无效操作：
  • 执行mvn clean install -Dmaven.test.skip=true -DfailIfNoTests=false构建WAR模块
  • 在依赖中添加<scope>compile</scope>和<type>jar</type>配置
• 运行环境：Maven v3.8.5，OpenJDK v17.0.5，基于Ubuntu22.04的KDE Neon系统
• 当前依赖配置：

<dependency>
   <groupId>com.findology.f2</groupId>
   <artifactId>biz-lib</artifactId>
   <version>${f2.version}</version>
</dependency>

解决方法 #

1. 显式声明tests分类依赖 #

Maven不会自动识别tests类型的jar包，需在依赖中明确指定<classifier>tests</classifier>，同时根据实际使用场景设置scope：

<dependency>
   <groupId>com.findology.f2</groupId>
   <artifactId>biz-lib</artifactId>
   <version>${f2.version}</version>
   <classifier>tests</classifier>
   <!-- 测试代码依赖用test scope，主代码若需调用测试类则用compile（不推荐但适配老旧代码） -->
   <scope>test</scope>
</dependency>

2. 检查biz-lib模块的打包配置 #

确保biz-lib模块的pom中配置了测试jar的打包逻辑，使用maven-jar-plugin的test-jar目标：

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

配置完成后，重新构建并安装biz-lib模块：

mvn clean install -pl biz-lib -am

3. 清理本地仓库元数据后重新安装 #

本地仓库的tests jar可能存在元数据缺失，删除对应目录后重新构建：

rm -rf ~/.m2/repository/com/findology/f2/biz-lib/1.3-SNAPSHOT
mvn clean install -pl biz-lib

4. 验证本地仓库元数据 #

进入~/.m2/repository/com/findology/f2/biz-lib/1.3-SNAPSHOT目录，检查maven-metadata-local.xml文件是否包含tests jar的相关条目。若缺失，重新执行install生成完整元数据。

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