如何在微服务CI流程中整合跨Maven项目的TestNG测试

一、先搞定common-tests的正确打包 #

你之前遇到类找不到的问题，大概率是common-tests没把测试类打包成可供依赖的JAR。在common-tests的pom.xml里添加以下配置，让Maven生成包含测试类的专用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>

执行mvn clean install后，会生成两个JAR：一个是主JAR（空的，因为这是纯测试仓库），另一个是common-tests-${version}-tests.jar——这个就是包含所有TestNG测试类和套件的核心文件。

二、微服务项目引入测试依赖 #

在微服务的pom.xml里，添加common-tests的测试依赖，确保scope设为test，type设为test-jar：

<dependencies>
    <dependency>
        <groupId>你的common-tests组ID</groupId>
        <artifactId>common-tests</artifactId>
        <version>对应版本号</version>
        <scope>test</scope>
        <type>test-jar</type>
    </dependency>
</dependencies>

如果CI流程是先克隆common-tests，记得在运行微服务测试前，先进入common-tests目录执行mvn clean install，把测试JAR安装到CI机器的本地Maven仓库，这样微服务项目就能自动拉取到依赖。

三、调整TestNG父套件顺序 #

修改微服务项目里的父测试套件XML，把common-tests里的func-test套件通过类路径引用，插入到install和uninstall之间。示例如下：

<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name="微服务全流程测试" verbose="1">
    <suite-files>
        <!-- 原有的install测试套件 -->
        <suite-file path="install-tests.xml"/>
        <!-- 引入common-tests里的func-test套件 -->
        <suite-file path="classpath:func-test-suite.xml"/>
        <!-- 原有的升级/回滚测试 -->
        <suite-file path="upgrade-rollback-tests.xml"/>
        <!-- 原有的uninstall测试套件 -->
        <suite-file path="uninstall-tests.xml"/>
    </suite-files>
</suite>

注意：func-test-suite.xml是common-tests里的套件文件名，如果它在JAR的子目录下，要写完整类路径（比如classpath:com/yourcompany/tests/func-test-suite.xml）。

四、CI流程简化 #

现在CI只需要按以下步骤执行即可：

1. 克隆微服务仓库和common-tests仓库
2. 进入common-tests目录，执行mvn clean install
3. 进入微服务仓库，执行原有的测试命令（比如mvn test -DsuiteXmlFile=父套件.xml）
   这样就能自动按install → func-test → 升级回滚 → uninstall的顺序跑完全流程，不用拆分复杂的Jenkins任务。

排查类找不到的常见坑 #

• 确认common-tests的test-jar插件配置正确，执行mvn install后，本地仓库里的tests.jar解压后能看到测试类和套件XML
• 微服务依赖里的groupId、artifactId、version和common-tests的pom完全一致
• 测试套件XML里的路径必须带classpath:前缀，确保能从依赖JAR里加载套件

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