跳到主要内容
版本:Next

TaskGraph 与三条线程边界:什么时候能并行,什么时候只能排队

多线程问题在 UE 里很少表现为崩溃,更多是「偶发错乱」:偶尔一帧模型没了、偶尔数据对不上、偶尔在上传纹理时卡 20 ms。这类问题的共同根源是代码跑在了不属于它的线程上,而编译器不会告诉你。

线程名与 API 按 UE5 稳定结构描述;具体的任务队列名与并行度参数随平台和版本变化,落地以当前版本 TaskGraphInterfaces.h、RenderingThread.h 为准。

三条线程,三种权限​

线程能碰什么绝对不能碰典型入口
游戏线程全部 UObject、世界状态、GC长时间阻塞Tick、蓝图、游戏逻辑
渲染线程场景代理(FPrimitiveSceneProxy)、渲染资源描述UObject(GC 看不见它)、世界状态ENQUEUE_RENDER_COMMAND
RHI 线程命令列表提交、底层图形 API一切游戏对象RHI 命令队列
TaskGraph worker纯数据计算未加锁的共享容器、UObject 生命周期ParallelFor、UE::Tasks

判定口诀:数据是「谁的」,就只在那个线程改它。 渲染线程拿到 AActor* 不是「不能用」,而是「用了不知道它什么时候被 GC 掉」。

ENQUEUE_RENDER_COMMAND 的三个陷阱​

这是跨线程最常见的入口,也是踩坑最集中的地方。

// 反例:捕获 UObject 裸指针
ENQUEUE_RENDER_COMMAND(UpdateTint)(
[this, Material](FRHICommandListImmediate& RHICmdList)
{
// 渲染线程执行时,this 可能已经被销毁;GC 也扫不到这个捕获
Material->SetVectorParameterValue(TEXT("Tint"), Color);
});
陷阱后果正确做法
捕获 UObject* 裸指针悬空指针,偶发崩溃在游戏线程取好纯数据(FVector4、句柄)再传
捕获 this(Actor/Component)同上只捕获需要的值,或 TWeakObjectPtr + 进线程前判有效
以为它是同步的下一行代码读到旧状态需要同步就 FlushRenderingCommands() 或 FRenderCommandFence
在渲染线程里 check() 游戏线程状态随机触发断言断言里只用 IsInRenderingThread()

正确的形态是先把数据抽干净,再进队:

void UVMTintComponent::PushTintToRender(const FLinearColor& InColor)
{
// 游戏线程:只取样,不解引用
const FVector4 Packed(InColor.R, InColor.G, InColor.B, InColor.A);
TWeakPtr<FSceneProxyRef, ESPMode::ThreadSafe> WeakProxy = ProxyRef;

ENQUEUE_RENDER_COMMAND(UpdateTint)(
[WeakProxy, Packed](FRHICommandListImmediate&)
{
if (auto Pinned = WeakProxy.Pin())
{
Pinned->SetTint(Packed); // 只改渲染侧自己的数据
}
});
}

需要「等」的时候:Fence 而不是 Sleep​

渲染命令是异步的。要确认「真的画完了」,用 fence;用 Sleep 只会让帧率崩掉。

FRenderCommandFence Fence;
Fence.BeginFence(); // 游戏线程调用,标记插入点
Fence.Wait(); // 阻塞到该点执行完;只在必要时用
Fence.IsFenceComplete(); // 更常见的用法:非阻塞轮询
场景用什么注意
截图/读回像素FRenderCommandFence + 轮询别在 Tick 里 Wait()
释放渲染资源BeginReleaseResource + FRenderCommandFence释放也要排到渲染线程
关卡切换FlushRenderingCommands()会造成明显卡顿,只在加载时用
每帧同步不要同步改成「下一帧用」的设计

ParallelFor:并行的收益在粒度,不在核数​

ParallelFor 会把 [0, Count) 切成若干块分给 worker。它适合纯数据、无共享写、每项工作量相当的循环。

ParallelFor(Particles.Num(), [&Particles](int32 Index)
{
// 只写 Particles[Index],不碰别的元素,不分配内存,不加锁
Particles[Index].Velocity += Gravity * DeltaTime;
});
误用症状原因
循环体里 SpawnActor崩溃 / 世界状态错乱只有游戏线程能改世界
每项只做几十纳秒的计算比串行还慢任务切分与同步开销超过收益
相邻元素写同一 cache line多核反而更慢false sharing,用 padding 或按块处理
在循环里 new / TArray::Add偶发崩溃分配器与容器不是线程安全的
捕获引用后异步使用悬空引用ParallelFor 是阻塞的,但内部任务可能在返回后仍在跑(带 EParallelForFlags 时)

一个经验阈值:单次迭代低于 10 微秒的循环,先量再并行。 并行化本身有不小的固定开销。

数据竞争怎么验​

不要靠「看起来没问题」。三种手段按成本从低到高:

手段做什么能发现什么
check(IsInGameThread())在关键函数入口断言线程调用方搞错线程(最常见)
check(IsInRenderingThread())同上,渲染侧渲染命令体里误调游戏逻辑
TSan(ThreadSanitizer)编译期插桩,运行期报竞争未加锁的共享写,能给出两份调用栈
压测 + 多倍并行度把 ParallelFor 强制单线程对照并行引入的时序问题

TSan 是最值得投入的一项:它能把「偶发」变成「必现的报错」,但需要对整个模块重编译,通常只在专门的性能分支上跑。

与异步加载的接缝​

FStreamableManager 的完成回调落在哪个线程,取决于你用的是哪条加载入口,而不是「一定在游戏线程」。写的时候不要假设,用断言验证一次:

RequestAsyncLoad(Paths, FStreamableDelegate::CreateLambda([this]()
{
check(IsInGameThread()); // 如果不是,这一行会立刻告诉你
OnAssetsReady();
}));

如果断言没过,说明这条加载路径的回调在别的线程上,所有对 UObject 的访问都要改成「投递回游戏线程」再处理:

AsyncTask(ENamedThreads::GameThread, [this]() { OnAssetsReady(); });

检查清单​

  1. 这行代码改的数据属于哪个线程?归属线程之外只读,不写。
  2. 跨线程传的是值还是指针?指针必须是线程安全的弱引用。
  3. 有没有在渲染命令里碰 UObject?有就抽数据。
  4. 需要同步吗?能改成「下一帧生效」就先改。
  5. 并行循环里有没有分配、加锁、写相邻元素?
  6. 关键入口有没有线程断言?没有就补一个,比事后查崩溃便宜得多。