TestNG 6.9.x升级至6.11+：priority优先级高于preserveOrder的适配问题

我之前帮几个团队解决过TestNG升级时的这个执行顺序问题，刚好对你的场景很熟悉。TestNG 6.10这次的执行顺序优先级调整确实坑了不少维护遗留代码的人，不过有几个明确的解决方案可以适配：

先明确核心问题 #

TestNG 6.10对执行顺序的优先级做了重新排序，优先级从低到高为：
groupByInstance < preserveOrder < priority < dependsOnGroups < dependsOnMethods
也就是说，如果你的测试套件配置了groupByInstance="true"或者preserveOrder="true"，这两个配置会先于priority生效，导致你原来依赖priority控制的用例顺序被打乱。

解决方案1：调整TestNG全局配置（最快捷） #

如果你的项目没有强依赖groupByInstance或preserveOrder的逻辑，直接在testng.xml里关闭这两个配置，让priority恢复原来的控制权：

<suite name="YourTestSuite" groupByInstance="false" preserveOrder="false">
    <test name="YourTest">
        <!-- 你的测试类/方法配置 -->
    </test>
</suite>

这样修改后，TestNG会完全按照@Test(priority = x)的数值从小到大执行用例，和6.9.x版本的行为一致。

解决方案2：适配现有配置，统一管理同组用例的优先级 #

如果必须保留groupByInstance或preserveOrder（比如需要按实例分组执行），可以给同一实例/分组下的用例设置连续的priority值，确保同组内的顺序由priority控制。比如同一个测试类的用例：

public class LegacyTest {
    @Test(priority = 1)
    public void testInit() { /* ... */ }

    @Test(priority = 2)
    public void testBusinessLogic() { /* ... */ }

    @Test(priority = 3)
    public void testCleanup() { /* ... */ }
}

即使groupByInstance生效，同一实例内的用例还是会按priority的顺序执行，不会出现乱序。

解决方案3：自定义注解转换器，强制优先级逻辑 #

如果需要更灵活的控制（比如部分用例要忽略全局配置），可以实现TestNG的IAnnotationTransformer接口，在运行时动态调整测试方法的优先级：

import org.testng.IAnnotationTransformer;
import org.testng.annotations.ITestAnnotation;
import java.lang.reflect.Method;

public class PriorityEnforcerTransformer implements IAnnotationTransformer {
    @Override
    public void transform(ITestAnnotation annotation, Class<?> testClass, Method testMethod) {
        // 示例：给所有带有特定前缀的方法设置最高优先级
        if (testMethod.getName().startsWith("critical_")) {
            annotation.setPriority(0);
        }
        // 也可以根据原有priority值做调整，确保优先级逻辑不被覆盖
        Integer originalPriority = annotation.getPriority();
        if (originalPriority != null) {
            // 这里可以添加自定义逻辑，比如给原有优先级加偏移量，确保高于其他配置的影响
            annotation.setPriority(originalPriority);
        }
    }
}

然后在testng.xml里注册这个转换器：

<suite name="YourTestSuite">
    <listeners>
        <listener class-name="com.your.package.PriorityEnforcerTransformer"/>
    </listeners>
    <!-- 测试配置 -->
</suite>

解决方案4：逐步迁移到依赖关系注解（最健壮） #

如果你的用例之间有明确的依赖逻辑（而不是单纯的顺序），可以逐步把priority替换为dependsOnMethods或dependsOnGroups。因为这两个注解的优先级比priority高，不会被其他配置干扰：

@Test(priority = 1)
public void testSetup() { /* 初始化操作 */ }

// 替换为dependsOnMethods，确保testExecute在testSetup之后执行
@Test(dependsOnMethods = "testSetup")
public void testExecute() { /* 业务逻辑测试 */ }

这种方式不仅能解决顺序问题，还能让测试用例的依赖关系更清晰，后期维护更方便。

根据你的项目实际情况选择最合适的方案：如果只是配置冲突，方案1最省心；如果需要保留原有分组逻辑，方案2足够；如果需要定制化控制，方案3更灵活；如果想优化测试架构，方案4是长期的最佳选择。

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