如何在xunit的[Theory]中运行时动态生成[InlineData]？

你遇到的核心问题是：xUnit的测试用例发现阶段（一般在构建完成后、测试实际运行前就会触发）会提前调用DataAttribute.GetData()、MemberData或ClassData来枚举所有测试用例，这时候你的运行时条件还未生效，导致无法动态生成符合预期的测试项。

以下是两种可行的解决方案：

方案一：在单个Fact测试中遍历动态数据（简单易实现） #

放弃让xUnit自动拆分多个测试用例，转而在一个[Fact]方法内部，等到测试真正运行时再生成数据并逐个执行测试逻辑。这种方式不需要复杂的扩展，适合大多数场景：

public class MyTests
{
    private readonly TestOutputHelper _testOutput;

    // 注入TestOutputHelper用于输出每个子测试的参数信息
    public MyTests(TestOutputHelper testOutput)
    {
        _testOutput = testOutput;
    }

    [Fact]
    public void DynamicTest()
    {
        // 运行时生成测试数据
        var testData = GetRuntimeTestData();

        // 用Assert.Multiple批量执行断言，避免一个子测试失败就终止整个测试
        Assert.Multiple(() =>
        {
            foreach (var dataItem in testData)
            {
                bool testParam = (bool)dataItem[0];
                _testOutput.WriteLine($"执行测试，参数：{testParam}");

                // 这里写入你的实际测试逻辑
                if (testParam)
                {
                    Assert.True(true); // 示例断言，替换为你的业务校验
                }
                else
                {
                    Assert.False(false); // 示例断言，替换为你的业务校验
                }
            }
        });
    }

    // 真正在运行时生成测试数据的方法
    private IEnumerable<object[]> GetRuntimeTestData()
    {
        yield return new object[] { false };
        // 这里的条件会在测试运行时才判断
        if (CheckRuntimeCondition())
        {
            yield return new object[] { true };
        }
    }

    // 模拟运行时才会确定的条件（比如读取环境变量、配置文件等）
    private bool CheckRuntimeCondition()
    {
        return Environment.GetEnvironmentVariable("ENABLE_TRUE_TEST") == "1";
    }
}

方案二：自定义测试用例发现器（实现独立测试用例显示） #

如果希望每个动态生成的数据项都作为独立的测试用例在测试报告中显示，可以通过实现xUnit的扩展点来延迟测试用例的生成到运行时。这种方式实现复杂度较高，但体验更接近原生InlineData：

步骤1：定义自定义特性 #

[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
// 指定自定义的测试用例发现器
[TestCaseDiscoverer("YourProjectNamespace.RuntimeDataDiscoverer", "YourTestProjectAssemblyName")]
public class RuntimeDataAttribute : Attribute
{
}

步骤2：实现测试用例发现器和执行器 #

using Xunit.Abstractions;
using Xunit.Sdk;

namespace YourProjectNamespace
{
    public class RuntimeDataDiscoverer : ITestCaseDiscoverer
    {
        public IEnumerable<ITestCase> Discover(ITestFrameworkDiscoveryOptions discoveryOptions, ITestMethod testMethod, IAttributeInfo attribute)
        {
            // 返回自定义的测试用例，延迟数据生成到执行阶段
            yield return new RuntimeDynamicTestCase(testMethod);
        }
    }

    public class RuntimeDynamicTestCase : ITestCase
    {
        private readonly ITestMethod _testMethod;

        public RuntimeDynamicTestCase(ITestMethod testMethod)
        {
            _testMethod = testMethod;
            DisplayName = $"Dynamic Test - {testMethod.Method.Name}";
        }

        public string DisplayName { get; }
        public string UniqueID => $"{_testMethod.Method.Name}_{Guid.NewGuid()}";
        public ITestMethod TestMethod => _testMethod;

        public Task<RunSummary> RunAsync(ITestFrameworkExecutionOptions executionOptions, IMessageSink diagnosticMessageSink, IMessageBus messageBus, object[] constructorArguments)
        {
            var summary = new RunSummary();
            // 测试执行时才生成动态数据
            var testData = GetRuntimeTestData();

            foreach (var dataItem in testData)
            {
                // 用xUnit原生的TestCase执行每个数据项
                var nativeTestCase = new XunitTestCase(
                    diagnosticMessageSink,
                    executionOptions,
                    _testMethod,
                    dataItem
                );

                // 执行单个测试用例并汇总结果
                var caseResult = nativeTestCase.RunAsync(executionOptions, diagnosticMessageSink, messageBus, constructorArguments).Result;
                summary.Total += caseResult.Total;
                summary.Failed += caseResult.Failed;
                summary.Skipped += caseResult.Skipped;
            }

            return Task.FromResult(summary);
        }

        private IEnumerable<object[]> GetRuntimeTestData()
        {
            yield return new object[] { false };
            if (CheckRuntimeCondition())
            {
                yield return new object[] { true };
            }
        }

        private bool CheckRuntimeCondition()
        {
            return Environment.GetEnvironmentVariable("ENABLE_TRUE_TEST") == "1";
        }
    }
}

步骤3：使用自定义特性 #

public class MyTests
{
    [RuntimeData]
    public void DynamicTest(bool testParam)
    {
        // 你的测试逻辑
        if (testParam)
        {
            Assert.True(true);
        }
        else
        {
            Assert.False(false);
        }
    }
}

方案对比 #

• 方案一：实现简单，无需了解xUnit内部机制，但所有动态测试会被合并为一个测试用例，失败时需要查看输出定位具体参数。
• 方案二：每个动态数据项作为独立测试用例显示，测试报告更清晰，但实现复杂，需要维护自定义的扩展逻辑。

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