xUnit中自定义TestClassOrderAttribute无法识别，需控制测试类执行顺序

核心问题分析 #

xUnit的TestCollectionOrderer仅负责测试集合之间的排序，无法直接读取测试类上的自定义属性；而测试用例排序器（TestCaseOrderer）运行时测试类已加载，无法干预类的执行顺序。要实现测试类维度的排序，需利用xUnit的测试发现扩展点，在测试发现阶段重排序同集合内的测试类。

实现步骤（无第三方依赖） #

1. 统一测试集合归属

确保所有需要排序的测试类都归属同一个测试集合，比如你已定义的BasicTestCollectionDefinition：

// 测试类A，排序优先级1
[Collection(nameof(BasicTestCollectionDefinition))]
[TestClassOrder(1)]
public class UserLoginTests
{
    // 测试用例...
}

// 测试类B，排序优先级2
[Collection(nameof(BasicTestCollectionDefinition))]
[TestClassOrder(2)]
public class UserProfileTests
{
    // 测试用例...
}

2. 自定义测试发现器与测试框架

在infra项目中实现自定义测试发现逻辑，在测试发现阶段对同集合内的测试类按TestClassOrderAttribute排序：

using Xunit.Abstractions;
using Xunit.Sdk;

// 自定义测试发现器，重写测试集合的测试类顺序
public class OrderedTestFrameworkDiscoverer : XunitTestFrameworkDiscoverer
{
    public OrderedTestFrameworkDiscoverer(ITestFramework framework, IMessageSink diagnosticMessageSink)
        : base(framework, diagnosticMessageSink) { }

    public override IEnumerable<ITestCollection> Discover(bool includeSourceInformation, IMessageBus messageBus)
    {
        var originalCollections = base.Discover(includeSourceInformation, messageBus).ToList();
        
        foreach (var collection in originalCollections)
        {
            // 提取测试类的排序值并排序
            var orderedTestClasses = collection.TestClasses
                .Select(tc => new 
                { 
                    TestClass = tc, 
                    Order = tc.Class.GetCustomAttributes(typeof(TestClassOrderAttribute))
                               .FirstOrDefault() is TestClassOrderAttribute attr ? attr.Order : int.MaxValue
                })
                .OrderBy(x => x.Order)
                .Select(x => x.TestClass)
                .ToList();
            
            // 返回排序后的测试集合
            yield return new OrderedTestCollection(collection, orderedTestClasses);
        }
    }
}

// 包装测试集合，替换排序后的测试类列表
public class OrderedTestCollection : ITestCollection
{
    private readonly ITestCollection _original;
    private readonly List<ITestClass> _orderedClasses;

    public OrderedTestCollection(ITestCollection original, List<ITestClass> orderedClasses)
    {
        _original = original;
        _orderedClasses = orderedClasses;
    }

    public string DisplayName => _original.DisplayName;
    public ITypeInfo DefinitionType => _original.DefinitionType;
    public IEnumerable<ITestClass> TestClasses => _orderedClasses;
    public string UniqueID => _original.UniqueID;
}

// 自定义测试框架，绑定自定义发现器
public class OrderedTestFramework : XunitTestFramework
{
    public OrderedTestFramework(IMessageSink diagnosticMessageSink)
        : base(diagnosticMessageSink) { }

    protected override ITestFrameworkDiscoverer CreateDiscoverer(IAssemblyInfo assemblyInfo)
    {
        return new OrderedTestFrameworkDiscoverer(this, DiagnosticMessageSink);
    }
}

3. 注册自定义测试框架

在测试项目的程序集信息文件（如AssemblyInfo.cs）中注册自定义测试框架：

[assembly: TestFramework("YourNamespace.OrderedTestFramework", "infra")]

4. 保留原有测试用例排序逻辑

你已实现的TestCaseOrderAttribute和TestCaseOrderer可继续使用，测试用例的排序逻辑不受影响。

关键注意事项 #

• 未标记TestClassOrderAttribute的测试类会被默认排到最后（使用int.MaxValue作为排序值）
• 确保已禁用测试并行化（你已配置），否则测试类可能会被并行执行，排序逻辑失效
• 不同测试集合的顺序仍由TestCollectionOrderer控制，若需跨集合排序可继续扩展集合排序器

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