NUnit环境下Task.Run调用SqlConnection执行SQL出现超时异常如何解决

1 先修复基础代码错误 #

你贴出的异步方法签名存在语法错误：

// 错误写法：async标记方法不能直接返回自定义类型Item
public static async Item GetItemAsyncTest()
{
    return await Task.Run(() => GetItemById(12));
}

.NET要求async标记的方法只能返回void、Task、Task<T>，正确的写法应该是：

public static async Task<Item> GetItemAsyncTest()
{
    // 额外说明：用Task.Run包装同步IO操作属于假异步，建议直接改为原生异步方法调用ExecuteReaderAsync
    return await Task.Run(() => GetItemById(12));
}

同时NUnit的测试方法如果调用异步逻辑，必须声明为async Task，不能用同步方法加.Result/.Wait()，也不能声明为async void，否则会触发.NET Framework经典的同步上下文死锁，超时只是死锁的表现。

2 最高概率触发问题的原因：单元测试事务跨线程锁等待 #

绝大多数单元测试会默认开启自动事务回滚机制，保证测试数据不污染数据库，默认创建的TransactionScope没有开启异步流支持，事务上下文只会绑定在主线程，当你用Task.Run把查询逻辑扔到子线程后：

• 子线程没有继承到主线程的事务上下文
• 主线程的事务还持有查询涉及的表/行锁
• 子线程的查询请求一直等待锁释放，最终触发超时

而Controller运行环境没有单元测试的自动事务逻辑，所以运行正常。
修复方案：创建事务时明确开启异步流支持

using (var scope = new TransactionScope(TransactionScopeAsyncFlowOption.Enabled))
{
    // 测试逻辑
    scope.Complete();
}

3 其他可能触发问题的原因 #

• NUnit运行环境线程池配置不足：.NET Framework下NUnit默认的线程池最小工作线程数很低，并发请求超过阈值后会排队，叠加数据库超时设置就会触发异常，可在测试初始化时增加最小线程数验证：ThreadPool.SetMinThreads(10, 10);
• 连接字符串配置差异：检查单元测试项目的App.config和Web项目的Web.config中连接字符串的Connection Timeout、Max Pool Size等配置是否一致
• 连接池泄露：确认你的IDatabaseConnection实现类的Dispose方法是否正确释放了底层SqlConnection，避免连接池被占满导致新连接等待超时。

优化建议 #

不要用Task.Run包装同步数据库操作，属于无意义的假异步，直接把数据访问层改为原生异步实现，调用ExecuteReaderAsync、OpenAsync等异步API，既可以真正提升吞吐量，也能避免同步上下文导致的各类异常。

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