游戏客户端架构 / 系统课时
后台结果怎样安全回到主线程
后台结果怎样安全回到主线程
后台任务完成后,游戏客户端需要把计算或加载结果交给主线程,再通知角色、界面等模块更新状态。本课使用 Unity、ConcurrentQueue 和主线程事件派发实现一条安全交接链路,让后台只负责生产数据,由主循环统一决定何时消费和通知订阅者。
学习目标
- 设计后台生产、线程安全队列和主线程消费的消息链路。
- 使用 Unity C# 实现可运行的异步结果事件桥接。
- 处理每帧消费预算、错误结果、任务取消和消息时序问题。
把线程切换设计成明确的消息边界
后台结果不应直接调用游戏逻辑订阅者,因为订阅者可能访问 Transform、UI 或其他只能在主线程操作的对象。即使事件总线本身使用线程安全容器保存订阅关系,也不代表订阅回调天然拥有主线程执行保证。
一种简单可靠的设计是把后台任务视为生产者,把主线程的 Update 视为消费者。生产者创建不包含引擎对象引用的结果消息,将其写入 ConcurrentQueue<T>;主线程在每帧取出一定数量的消息,检查结果后再触发游戏事件。

这里的线程安全来自两个不同层次:ConcurrentQueue<T> 保证多线程入队与出队操作的并发安全;主线程消费规则保证依赖 Unity 对象的订阅者只在主线程执行。二者缺一不可。
消息最好携带任务 ID、结果值、错误信息或状态版本等必要字段,而不是直接传递仍在变化的共享对象。生产者完成消息构造后再入队,消费者只处理这份稳定结果。
实现一个可运行的 Unity 事件桥
下面的脚本模拟后台计算积分总和,并把结果放入队列。Update 每帧最多消费 8 条结果,成功后发布 ScoreReady 事件,订阅处理器再修改物体位置。
创建 Assets/MainThreadEventBridge.cs,把脚本挂到场景中的活动 GameObject。示例使用标准 .NET 并发队列与 Unity 的 MonoBehaviour 生命周期。
using System;
using System.Collections.Concurrent;
using System.Threading;
using System.Threading.Tasks;
using UnityEngine;
public sealed class MainThreadEventBridge : MonoBehaviour
{
private readonly ConcurrentQueue<WorkResult> _queue =
new ConcurrentQueue<WorkResult>();
private CancellationTokenSource _stop;
public event Action<int> ScoreReady;
private void Awake()
{
_stop = new CancellationTokenSource();
ScoreReady += ApplyScore;
}
private void Start()
{
var inbox = _queue;
var token = _stop.Token;
_ = Task.Run(() =>
{
try
{
int total = 0;
for (int i = 1; i <= 100; i++)
total += i;
// 后台仅投递普通 C# 数据,不访问 Unity 对象。
if (!token.IsCancellationRequested)
inbox.Enqueue(new WorkResult(total, null));
}
catch (Exception ex)
{
if (!token.IsCancellationRequested)
inbox.Enqueue(new WorkResult(0, ex.Message));
}
});
}
private void Update()
{
// 限制每帧消费数量,避免事件处理长期占用主循环。
for (int n = 0; n < 8 && _queue.TryDequeue(out var result); n++)
{
if (result.Error != null)
{
Debug.LogError($"compute.failed={result.Error}");
continue;
}
ScoreReady?.Invoke(result.Value);
}
}
private void ApplyScore(int value)
{
transform.position = new Vector3(value / 1000f, 0f, 0f);
Debug.Log($"score.ready={value}");
}
private void OnDestroy()
{
// 停止接收新结果,并解除当前对象的事件订阅。
_stop.Cancel();
ScoreReady -= ApplyScore;
_stop.Dispose();
}
private readonly struct WorkResult
{
public readonly int Value;
public readonly string Error;
public WorkResult(int value, string error)
{
Value = value;
Error = error;
}
}
}预期结果:进入 Play 模式后,后台任务计算出 5050,主线程在后续某一帧消费消息,Unity Console 输出:
score.ready=5050同时,挂载脚本的物体移动到 (5.05, 0, 0)。具体在哪一帧出现日志取决于线程调度与任务完成时间,不能假定结果会在启动后的第一帧到达。
代码中的 ScoreReady 是运行在主线程上的 C# 事件。实际项目可以将 ScoreReady?.Invoke(result.Value) 替换为统一事件总线的 Publish 调用,但前提是这次发布确实发生在主线程。
处理错误、取消和对象销毁
工作线程中的异常不能依赖主线程自动捕获。示例把异常消息封装成失败结果入队,再由主线程输出错误日志。这样成功结果与失败结果都经过同一条交接路径,方便后续接入错误事件、重试策略或调试记录。
OnDestroy 会发出取消信号,后台在入队前检查该信号。需要注意,取消标记不会强制终止已经运行的计算;如果任务在销毁前已经入队,队列中的结果也不意味着必须继续执行。示例对象销毁后不再调用其 Update,因此不会继续通过该对象消费消息。
实际游戏还可能存在更复杂的生命周期:例如同一角色重新生成,旧请求结果在新角色出现后才返回。此时,仅检查对象是否存在并不够,还应为请求附加 requestId、角色实体 ID 或状态版本,消费时验证消息仍属于当前有效任务。
控制队列长度和事件执行顺序
限制每帧最多处理 8 条消息,可以避免某一帧无限制地执行订阅逻辑,但这并不限制后台入队速度。如果生产速度持续超过消费速度,队列仍会增长,造成内存压力和消息延迟。
生产环境需要根据事件类型选择策略:
- 必须逐条处理的结果:例如交易确认、任务完成记录,保留消息并监控积压数量。
- 允许合并的状态更新:例如下载进度、实时数值预览,可以只保留最新状态。
- 已经过期的结果:例如旧场景加载请求或被替代的搜索任务,应在消费前丢弃。
ConcurrentQueue<T> 按实际入队顺序提供先进先出消费,但多个后台任务的完成及入队先后并不确定。如果业务需要按请求发起顺序处理,应在消息中增加序号,并由主线程进行排序、等待或版本校验,而不是假定任务启动顺序就是结果到达顺序。
还要区分队列异常与订阅者异常。队列并发安全不意味着事件处理器不会抛异常;直接使用 C# 多播事件时,一个订阅者抛出的异常可能中断后续订阅者。重要的生产事件总线应建立独立的异常隔离与日志策略。
这套桥接方式适合后台加载、网络回调、文件解析和计算任务向游戏逻辑提交结果。关键约束始终一致:后台只生产稳定数据,线程安全队列负责交接,主线程负责验证、派发和修改游戏状态。