游戏客户端架构 / 系统课时
异步任务取消后消息怎么办
异步任务取消后消息怎么办
玩家切换场景、关闭界面或等待请求超时时,先前启动的异步任务可能仍在运行,甚至继续发布完成消息。如果这些晚到结果直接修改游戏状态,就会覆盖新的操作结果。本课用取消令牌、请求版本和主线程消费校验建立可靠的失效消息处理机制。
学习目标
- 理解任务取消、执行完成和消息消费之间的区别。
- 使用请求代次识别超时、取消或状态切换后的晚到消息。
- 实现异步结果发布与消费时的双重有效性检查。
取消为什么不等于撤回消息
在 C# 中,CancellationToken 表达的是取消请求,而不是强制终止线程。异步操作只有主动检查令牌,或者调用支持取消的 API,才会及时停止。部分网络库、第三方 SDK 或已经提交到外部服务的任务可能无法立即取消。
更关键的是,任务完成与事件消费是两个不同阶段。即使任务在收到取消请求前已经把结果放入队列,消费者也可能在玩家离开界面后才处理这条消息。因此,单纯在异步任务内部检查取消状态无法完全消除晚到事件。
一个典型的错误过程是:玩家选择关卡 A,启动加载;随后切换到关卡 B,并取消 A 的加载;B 先完成并显示;A 后完成,又发出加载成功消息。如果消费者不检查消息归属,最终界面可能错误地显示关卡 A。
需要区分三种情况:
- 取消成功:任务在执行阶段观察到取消令牌,停止后续工作,不再发布成功结果。
- 取消未生效:外部操作无法中断,旧任务最终仍产生结果,需要在交接或消费时丢弃。
- 已经入队:任务取消前消息已进入队列,必须由消费者重新判断其是否仍然有效。
按请求代次过滤晚到消息
可靠的方法是给每一轮异步请求分配递增的请求代次 generation。开始新请求时更新当前代次,并请求取消旧任务;完成消息携带启动时的代次。消费者只接受代次与当前状态一致的结果。

代次应属于具体的状态所有者,例如一个背包面板、一轮场景加载或一个角色数据查询,而不是让所有互不相关的任务共用单一全局版本。这样某个界面的新请求不会误伤其他界面正在执行的合法任务。
消费前还应检查目标对象是否依然存在、界面是否仍处于活动状态。代次只解决新旧请求的归属问题,不代表对象一定仍可接收结果。
用代码复现并拦截晚到结果
下面使用 .NET 8 控制台程序模拟两个异步加载任务。旧任务故意忽略取消令牌,表示无法立即终止的外部操作;新任务先完成,旧任务后返回。两者都把结果放入线程安全队列,但消费者只应用当前代次的结果。
执行 dotnet new console -n AsyncCancellationDemo 创建项目,将代码保存到 Program.cs,再在项目目录执行 dotnet run。
using System;
using System.Collections.Concurrent;
using System.Threading;
using System.Threading.Tasks;
public readonly record struct LoadMessage(int Generation, string Level);
public static class Program
{
public static async Task Main()
{
var inbox = new ConcurrentQueue<LoadMessage>();
using var oldRequest = new CancellationTokenSource();
int activeGeneration = 1;
Task previous = LoadAsync(
1, "旧场景", 80, true, oldRequest.Token, inbox);
// 玩家切换目标:取消旧请求,同时让旧代次失效。
oldRequest.Cancel();
activeGeneration = 2;
Task current = LoadAsync(
2, "新场景", 10, false, CancellationToken.None, inbox);
await Task.WhenAll(previous, current);
string currentLevel = "未加载";
int accepted = 0;
int dropped = 0;
// 在状态所有者处检查,防止旧结果覆盖新状态。
while (inbox.TryDequeue(out var message))
{
if (message.Generation != activeGeneration)
{
dropped++;
continue;
}
currentLevel = message.Level;
accepted++;
}
Console.WriteLine($"应用:{accepted},丢弃:{dropped}");
Console.WriteLine($"当前场景:{currentLevel}");
}
private static async Task LoadAsync(
int generation, string level, int delayMs,
bool ignoresCancellation, CancellationToken cancellationToken,
ConcurrentQueue<LoadMessage> inbox)
{
try
{
// 模拟支持取消和不支持取消的两种外部操作。
var token = ignoresCancellation
? CancellationToken.None
: cancellationToken;
await Task.Delay(delayMs, token);
inbox.Enqueue(new LoadMessage(generation, level));
}
catch (OperationCanceledException)
when (cancellationToken.IsCancellationRequested)
{
// 正常取消不产生成功消息。
}
}
}预期输出:
应用:1,丢弃:1
当前场景:新场景旧任务虽然收到取消请求,却因为模拟的外部操作不支持取消而正常返回,并向队列写入代次为 1 的消息。新任务的代次为 2,因此消费者应用新结果,并丢弃旧结果。最终状态不会因异步完成顺序不同而回退。
示例在全部任务结束后集中出队,以便稳定复现结果。真实 Unity 客户端应在主线程的更新阶段消费队列,并在更新场景对象或 UI 之前完成代次及目标生命周期校验。
超时、销毁与错误消息如何处理
超时可以通过 CancellationTokenSource.CancelAfter(TimeSpan.FromSeconds(3)) 发出取消请求,但超时不代表底层操作已经停止。业务层还需要将对应请求标记为失效,通常通过推进当前代次实现。如果只是取消令牌却不改变有效性状态,无法保证迟到消息一定被拒绝。
当界面关闭或游戏对象销毁时,应取消相关任务、使其请求代次失效,并解除不再需要的订阅。已经进入队列的旧消息仍由消费者负责过滤,不能依赖任务取消自动清空队列。
错误消息也必须携带请求标识。旧请求失败时可以记录诊断日志,但不应覆盖新请求的成功状态,也不应在已经关闭的界面上弹出错误提示。主动取消引发的 OperationCanceledException 通常属于预期控制流程,其他异常则需要正常记录或上报。
如果晚到结果携带文件句柄、临时资源或可释放对象,丢弃消息时还必须按所有权协议释放资源,不能只跳过状态更新。取消令牌负责尽量停止无用工作,代次校验负责阻止失效结果生效,资源清理负责防止取消路径造成泄漏;三者共同构成安全的异步消息落地机制。