跳到主要内容
版本:5.8

FStreamableManager 异步回调的线程边界

FStreamableManager::RequestAsyncLoad 是异步资源加载最常用的入口。它本身不决定回调运行在哪个线程,这个语义由调用方选择的委托绑定方式和加载完成时的分发路径共同决定。把边界弄清楚,是分析加载期 UObject 生命周期的前提。

请求与句柄​

一次典型请求会返回一个 TSharedPtr<FStreamableHandle>,它既是取消入口,也是保持加载请求存活的引用:

TSharedPtr<FStreamableHandle> Handle = StreamableManager.RequestAsyncLoad(
AssetSoftPath,
FStreamableManagerDelegate::CreateUObject(this, &UMyLoader::OnLoaded),
FStreamableManager::AsyncLoadHighPriority
);
状态句柄行为注意点
加载中IsLoadingInProgress() 为真必须持有句柄,否则请求可能被提前释放
已完成HasLoadCompleted() 为真回调已分发,句柄仍可查询已加载资源
已取消CancelHandle() 后回调不再保证触发,需自行清理等待态

回调的线程语义​

关键结论:不要把「异步加载」直接理解成「回调在后台线程」。回调的分发受委托绑定方式与调用点所在的加载策略影响,实际工程中应以如下方式收敛不确定性:

void UMyLoader::OnLoaded()
{
// 假定回调可能来自非游戏线程:只做线程安全的转交
AsyncTask(ENamedThreads::GameThread, [WeakThis = TWeakObjectPtr<UMyLoader>(this)]()
{
if (WeakThis.IsValid())
{
WeakThis->ApplyLoadedAssets();
}
});
}

这样做的原因有三个:

  1. UObject 的反射访问、GC 相关操作与大部分引擎子系统都要求游戏线程;
  2. 加载完成与对象被销毁之间存在竞态,弱引用可以在转交后再次判活;
  3. 把「线程归属」集中在一处,比在每个回调里各自假设要容易审计。

生命周期风险​

异步加载最容易出问题的不是加载失败,而是回调到达时目标已经不在。常见组合是:关卡切换触发 CancelHandle(),但业务侧仍持有指向已销毁对象的裸指针;或者句柄本身被释放,导致完成通知被丢弃而等待态永远不结束。

对应做法:

  • 用 TWeakObjectPtr / TSharedPtr 明确所有权,避免回调里出现裸 this;
  • 在 BeginDestroy 或显式的 Cancel() 中统一取消并置空句柄;
  • 把「加载中」建模成可查询状态,而不是依赖回调一定到达。

与缓存层的关系​

加载完成只是把资源带进内存,不意味着引用会被长期持有。SkeletalMeshCache / StaticMeshCache 这类无界缓存如果只增不减,会在长时间运行的场景里持续推高常驻内存;相关分析见后续「内存管理」分组的缓存专题。本页只负责把加载回调的线程边界固定下来,作为那条分析链的前置条件。