Unity中使用含异步可等待方法的C#库如何避免主线程阻塞？

我编写了如下脚本：

public class Example : Monobehaviour
{
    public async void Start()
    {
        LibraryClass service = new LibraryClass();

        bool result = await service.Login();
        if (result == false)
        {
            Debug.LogError("Login Failed !!");
            return;
        }

        result = await service.Load();
        if (result == false)
        {
            Debug.LogError("Load Failed !!");
            return;
        }
    }
}

LibraryClass的方法签名如下：

public async Task<bool> Login();

以及

public async Task<bool> Load();

运行脚本时Unity主线程被阻塞，必须等待所有操作完成才能继续。尝试添加进度条，但直到两个方法完全执行完毕UI才会更新。于是我将脚本修改为如下形式：

public class Example : Monobehaviour
{
    private IEnumerator Start()
    {
        LibraryClass service = new LibraryClass();
        WaitForEndOfFrame wait = new WaitForEndOfFrame();

        Task<bool> task = service.Login();
        while (task.IsCompleted == false)
        {
            yield return wait;
        }
    
        if (task.Result == false)
        {
            Debug.LogError("Login Failed !!");
            return;
        }

        task = service.Load();
        while (task.IsCompleted == false)
        {
            yield return wait;
        }
    
        if (task.Result == false)
        {
            Debug.LogError("Load Failed !!");
            return;
        }
    }
}

情况有所改善，但主线程仍会被阻塞，UI和游戏其余部分停止更新。推测是因为库内部在HTTP请求、加载ZIP文件等操作中使用了多个await，但这些内部逻辑无法控制。请问有没有办法避免Unity主线程被完全阻塞？

1. 优化协程写法：直接等待Task对象 #

Unity支持在协程中直接yield return Task，调度器会自动在任务执行期间让出主线程，保证UI和游戏逻辑正常更新，无需手动循环判断完成状态：

private IEnumerator Start()
{
    LibraryClass service = new LibraryClass();

    Task<bool> loginTask = service.Login();
    yield return loginTask;
    if (!loginTask.Result)
    {
        Debug.LogError("Login Failed !!");
        yield break;
    }

    Task<bool> loadTask = service.Load();
    yield return loadTask;
    if (!loadTask.Result)
    {
        Debug.LogError("Load Failed !!");
        yield break;
    }
}

2. 在Async版本中显式让出主线程 #

如果偏好使用async/await，可以在任务执行期间通过Task.Yield()主动让出主线程，让Unity处理UI渲染和帧逻辑：

public async void Start()
{
    LibraryClass service = new LibraryClass();

    var loginTask = service.Login();
    while (!loginTask.IsCompleted)
    {
        await Task.Yield();
    }
    if (!loginTask.Result)
    {
        Debug.LogError("Login Failed !!");
        return;
    }

    var loadTask = service.Load();
    while (!loadTask.IsCompleted)
    {
        await Task.Yield();
    }
    if (!loadTask.Result)
    {
        Debug.LogError("Load Failed !!");
        return;
    }
}

3. 强制将库操作调度到后台线程 #

如果库内部存在同步阻塞代码（比如误用Task.Wait()或同步IO），可以将整个库方法调用包裹在Task.Run()中，强制在后台线程执行，彻底避免占用主线程：

public async void Start()
{
    LibraryClass service = new LibraryClass();

    bool loginResult = await Task.Run(() => service.Login());
    if (!loginResult)
    {
        Debug.LogError("Login Failed !!");
        return;
    }

    bool loadResult = await Task.Run(() => service.Load());
    if (!loadResult)
    {
        Debug.LogError("Load Failed !!");
        return;
    }
}

注意：该方法仅适用于库操作不涉及Unity主线程API（如操作GameObject、调用Unity内置方法）的场景，否则会触发线程安全错误。

4. 排查库内部阻塞点 #

如果以上方法均无效，说明库内部存在未正确异步化的同步阻塞逻辑。若无法修改库代码，可尝试：

• 使用ThreadPool.QueueUserWorkItem将库操作放到线程池执行，再通过协程等待结果
• 结合Unity的Job System隔离阻塞操作，前提是库操作支持非主线程安全执行

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