避坑指南：UniTask异步操作中WhenAll突然卡死？可能是取消方式用错了

避坑指南：UniTask异步操作中WhenAll突然卡死？可能是取消方式用错了

在Unity项目里，异步编程已经从“锦上添花”变成了“不可或缺”。UniTask凭借其轻量、高效以及与Unity引擎深度集成的特性，成为了许多开发者的首选。然而，从传统的协程或Task切换到UniTask，并非只是语法上的简单替换。我见过不少团队，兴冲冲地重构了异步代码，用上了WhenAll、WhenAny这些强大的组合器，却在某个深夜被测试报告里的“游戏卡死”或“内存泄漏”惊醒。问题往往不是出在UniTask本身，而是我们对待“取消”这一机制的态度过于随意了。

异步操作的取消，远非调用一个Cancel()那么简单。它关乎资源的及时释放、任务状态的清晰管理，以及整个异步流程的健壮性。尤其是在使用UniTask.WhenAll等待多个任务时，一个不恰当的取消操作，很可能让所有关联任务陷入一种“悬而未决”的状态，最终导致整个异步链卡死。这篇文章，我们就来深入聊聊UniTask中取消令牌（CancellationToken）的传播艺术，拆解WhenAll卡死的典型场景，并给出经过实战检验的安全取消方案。无论你是正在评估UniTask，还是已经在项目中大量使用却偶遇怪象，相信这些来自一线的经验都能帮你避开那些隐形的坑。

1. 理解CancellationToken：不只是“停止”信号

很多开发者将CancellationToken简单地视为一个开关——需要停止时，就调用CancellationTokenSource.Cancel()。这种理解在简单场景下或许够用，但在复杂的异步任务链中，就埋下了隐患。CancellationToken的核心机制是协作式取消和传播。

1.1 协作式取消与资源清理

协作式取消意味着，一个任务是否响应取消、何时响应取消，以及如何清理资源，是由任务自身的逻辑决定的。框架（这里是UniTask）只负责传递取消请求。

// 一个需要资源清理的异步任务示例
public async UniTask ProcessHeavyFileAsync(string path, CancellationToken ct)
{
    // 打开文件，获取一个需要释放的资源句柄
    using var fileStream = File.OpenRead(path);
    using var reader = new StreamReader(fileStream);

    var buffer = new char[1024];
    while (!reader.EndOfStream)
    {
        // 检查取消令牌，如果已取消，则跳出循环并执行后续清理
        ct.ThrowIfCancellationRequested();

        int bytesRead = await reader.ReadAsync(buffer, 0, buffer.Length).AsUniTask();
        // ... 处理数据 ...
    }
    // 循环正常结束，using语句会自动释放fileStream和reader
}

注意：ThrowIfCancellationRequested()会抛出OperationCanceledException。在UniTask中，这通常会导致任务进入取消状态。确保在抛出异常前，所有已获取的资源（如文件流、网络连接、Unity对象引用）都已被妥善释放或标记，否则就会导致资源泄漏。

1.2 令牌的创建与传播链路

一个清晰的取消令牌传播链路是安全异步编程的基石。混乱的令牌来源和传播是导致WhenAll卡死的主要原因之一。

public class GameService
{
    private CancellationTokenSource _sceneCts;

    public async UniTaskVoid StartGameSessionAsync()
    {
        // 为当前游戏会话创建一个专属的CancellationTokenSource
        _sceneCts = new CancellationTokenSource();
        var sessionToken = _sceneCts.Token;

        try
        {
            // 将令牌传播给所有子任务
            await UniTask.WhenAll(
                LoadPlayerDataAsync(sessionToken),
                InitializeWorldAsync(sessionToken),
                SpawnEnemiesAsync(sessionToken)
            );
        }
        catch (OperationCanceledException)
        {
            Debug.Log("游戏会话被取消。");
        }
        finally
        {
            // 确保清理CancellationTokenSource
            _scen