SpecFlow构造函数与异步BeforeScenario组合引发死锁问题

• 运行时：.NET 6.0.300
• 测试组件：SpecFlow 3.9.22、NUnit 3.13.2

同时满足以下两个条件时，测试执行会100%稳定触发死锁：

• 步骤定义（StepDefinition）类构造函数中初始化的业务对象，其自身构造逻辑通过.GetAwaiter().GetResult()方式同步阻塞调用async修饰的异步方法
• 步骤定义类中声明了标记[BeforeScenario]（别名[Before]）的async异步生命周期钩子方法

临时规避验证：移除BeforeScenario方法的async修饰符、注释掉方法内的await异步调用代码，死锁会暂时消失，但未解决本质问题。

SpecFlow 3.9.x 执行异步生命周期钩子、异步步骤时，默认采用单线程同步上下文调度：所有await后的续操作默认会被封送回最初启动执行的唯一上下文线程运行，和经典WPF/WinForm UI线程同步上下文、传统ASP.NET请求上下文的调度逻辑完全一致。死锁形成的完整链路如下：

1. 测试用例启动后，SpecFlow持有唯一的单线程同步上下文，开始执行标记[BeforeScenario]的异步钩子
2. 钩子方法执行到第一个await节点时，当前上下文线程暂时释放，但钩子的后续执行逻辑已经被排入同步上下文的等待队列，必须拿到上下文线程才能继续执行
3. 按照SpecFlow的对象实例化时机，此时会开始创建步骤定义类实例，触发步骤定义类的构造函数执行
4. 构造函数执行业务对象初始化时，调用.GetAwaiter().GetResult()同步阻塞当前持有的上下文线程，等待业务对象内部异步方法执行完成
5. 双向等待闭环形成：上下文线程被同步阻塞调用完全占住，既无法执行BeforeScenario钩子排队的续操作，也无法执行业务对象异步方法排队的续操作；而同步阻塞调用又在等待上述两个异步操作完成，死锁无超时会一直卡住。

以下方案不需要修改原有代码结构（即保留构造函数初始化业务对象、保留异步BeforeScenario钩子的写法），可彻底解决死锁：

• 最小改动方案：业务对象构造函数内的同步阻塞异步调用，以及异步方法内部的await调用，全部显式追加.ConfigureAwait(false)，指定续操作不需要捕获、返回原始同步上下文，直接在线程池线程执行，打破等待闭环。
• 规范异步写法方案：将步骤定义类中业务对象的初始化逻辑从构造函数迁移到[BeforeScenario]异步钩子中，全程使用await异步调用，彻底消除构造函数内的同步阻塞调用。
• 全局替换方案：自定义SpecFlow测试执行的同步上下文，替换默认的单线程上下文为线程池调度上下文，从根源上取消续操作必须回到原线程的限制（该方案改动较大，需要自定义SpecFlow运行插件，非特殊场景不推荐）。

死锁复现代码 #

业务服务类 #

public class TestBusinessService
{
    public TestBusinessService()
    {
        // 构造函数同步阻塞异步调用，死锁触发点1
        InitDataAsync().GetAwaiter().GetResult();
    }

    private async Task InitDataAsync()
    {
        // 模拟异步IO操作
        await Task.Delay(100);
    }
}

步骤定义类 #

[Binding]
public class DeadLockStepDefinitions
{
    private readonly TestBusinessService _service;

    public DeadLockStepDefinitions()
    {
        // 构造函数初始化业务对象
        _service = new TestBusinessService();
    }

    // 异步生命周期钩子，死锁触发点2
    [BeforeScenario]
    public async Task BeforeScenarioHook()
    {
        // 任意await异步调用即可触发死锁
        await Task.CompletedTask;
    }

    [Given(@"测试示例步骤")]
    public void GivenSampleTestStep()
    {
        // 普通步骤逻辑
    }
}

最小改动修复代码（对应最小改动方案） #

仅需修改业务服务类，追加ConfigureAwait(false)即可：

public class TestBusinessService
{
    public TestBusinessService()
    {
        // 显式指定不捕获同步上下文，打破死锁等待链
        InitDataAsync().ConfigureAwait(false).GetAwaiter().GetResult();
    }

    private async Task InitDataAsync()
    {
        // 异步方法内部同样追加ConfigureAwait(false)
        await Task.Delay(100).ConfigureAwait(false);
    }
}

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