C#异步方法中调用同步方法及对应编译器报错的解决方法

该报错是Microsoft.VisualStudio.Threading分析器抛出的规则警告，核心目的是避免异步上下文内的同步阻塞引发死锁、线程池饥饿等问题，错误提示原文如下：

DoSomething synchronously blocks. Await DoSomethingAsync instead

可选解决方法 #

1. 用编译指令抑制当前位置的警告 #

如果你明确当前同步调用没有死锁风险（比如同步方法执行耗时极短、当前运行环境无同步上下文），可以直接用#pragma指令临时关闭该规则的检查：

public async Task<int> DoStuff(bool runAsync) {
    int result;
    if (runAsync) {
        result = await DoSomethingAsync();
    } else {
#pragma warning disable VSTHRD103 // 明确不需要异步调用时抑制警告
        result = DoSomething();
#pragma warning restore VSTHRD103 // 恢复警告检查避免遗漏其他违规
    }
    return result;
}

2. 用Task.Run包裹同步调用 #

将同步操作调度到线程池执行，避免阻塞当前异步上下文，适合同步方法无对应异步实现、且耗时较长的场景：

public async Task<int> DoStuff(bool runAsync) {
    int result;
    if (runAsync) {
        result = await DoSomethingAsync();
    } else {
        result = await Task.Run(() => DoSomething());
    }
    return result;
}

注意：该方案会额外占用一个线程池线程，不适合高并发场景下的高频调用

3. 拆分同步/异步方法（更推荐的工程实践） #

避免用开关参数控制同步/异步逻辑，拆分为两个独立的方法从根源避免违规，符合C#常规编码规范：

// 异步方法
public async Task<int> DoStuffAsync() {
    return await DoSomethingAsync();
}

// 同步方法
public int DoStuff() {
    return DoSomething();
}

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