游戏引擎 / 系统课时
定位异步竞态和旧数据覆盖
定位异步竞态和旧数据覆盖
玩家先选角色 A 再选 B,A 的慢请求最后完成,却把界面换回旧角色。代码没有类型错误,单次测试也可能正常。本节用可控完成顺序重现竞态,以请求版本控制结果提交,并同时验证旧成功、旧失败、当前失败与界面失效。
学习目标
- 从启动顺序和完成顺序识别异步竞态。
- 保证只有当前有效请求更新数据与错误状态。
- 通过可控 Promise 复现边界,而不依赖随机延迟。
请求开始顺序不决定完成顺序
两次请求都可以正确完成,问题出在“谁拥有当前显示”。当需求是最后一次选择优先时,每次选择递增版本,完成时仅当前版本允许提交。旧失败也必须忽略,否则旧请求的错误会把新成功显示改成失败。
busy 适合拒绝重复提交,版本号适合允许新选择覆盖旧选择,两者目标不同。若使用同一个共享 loading 标记,旧请求的 finally 也可能把新请求仍在加载的状态清掉。状态清理同样需要归属检查,而不是只保护数据赋值。

用可控完成顺序验证提交
文件:main.ts,完整纯 TypeScript 主例程。deferred 是可手动结束的真实 Promise 夹具,不使用随机定时器。
export {};
function deferred<T>(): {
promise: Promise<T>; resolve: (value: T) => void; reject: (reason: Error) => void;
} {
let resolve!: (value: T) => void;
let reject!: (reason: Error) => void;
const promise = new Promise<T>((ok, fail) => { resolve = ok; reject = fail; });
return { promise, resolve, reject };
}
class LatestView {
value = 'placeholder';
status: 'idle' | 'loading' | 'ready' | 'error' = 'idle';
private version = 0;
invalidate(): void { this.version++; this.status = 'idle'; }
async select(task: Promise<string>): Promise<string> {
const request = ++this.version;
this.status = 'loading';
try {
const value = await task;
if (request !== this.version) return 'stale';
this.value = value; this.status = 'ready';
return 'ready';
} catch (error: unknown) {
// 旧失败与旧成功都无权改当前状态。
if (request !== this.version) return 'stale';
this.status = 'error';
return 'failed';
}
}
}
async function main(): Promise<void> {
const view = new LatestView();
const old = deferred<string>(), latest = deferred<string>();
const oldResult = view.select(old.promise), latestResult = view.select(latest.promise);
latest.resolve('new');
const a = await latestResult;
old.resolve('old');
console.log(`${a}|${await oldResult}|${view.value}|${view.status}`);
const oldFailure = deferred<string>(), next = deferred<string>();
const b = view.select(oldFailure.promise), c = view.select(next.promise);
next.resolve('newer'); await c;
oldFailure.reject(new Error('old network failure'));
console.log(`${await b}|${view.value}|${view.status}`);
console.log(`${await view.select(Promise.reject(new Error('current failure')))}|${view.status}`);
const leaving = deferred<string>();
const d = view.select(leaving.promise);
// 离开页面后,任何完成结果都不能重新激活显示。
view.invalidate(); leaving.resolve('late');
console.log(`${await d}|${view.value}|${view.status}`);
}
void main().catch((error: unknown) => { throw error; });预期输出:
ready|stale|new|ready
stale|newer|ready
failed|error
stale|newer|idle给日志补上请求归属
实际排查时记录请求版本、目标 id、开始与完成阶段,比较业务提交顺序。若只记录“加载成功”,两个请求都成功时仍看不出谁覆盖谁。错误日志也要保留归属,过期错误可以用于诊断,但不能更新当前界面的失败状态。
这里版本判断发生在 await 之后、赋值之前,中间没有新的异步等待,因此不会被另一段异步代码插入。如果提交过程自身还包含 await,需要在下一次提交前再次确认版本。对服务端写入而言,本地版本也不能保证远端顺序,必须有服务端或存储层策略。
当前请求失败时,本例保留最后一次成功值,同时把状态设为 error;这表示界面仍可展示旧可用内容并提示失败。若产品要求清空内容,应在当前失败分支明确赋值。无论选择哪种表现,旧失败都没有修改当前数据或状态的权限。
传入 task 必须在创建后立即交给负责处理失败的入口,避免先创建拒绝的 Promise、过很久才挂处理器造成未处理拒绝。例程在同步启动选择时就进入 await,错误归属与处理出口从一开始明确;不要通过延迟挂 catch 来模拟网络时序。
接到组件生命周期
在 Cocos 组件里,启动新选择时记录版本,onDisable 或 onDestroy 使已有版本失效,成功后再检查组件有效性与 enabledInHierarchy。不要在旧 Promise 的 finally 中无条件恢复新请求控制的按钮或提示。真正绑定、解绑和资源应用仍应在引擎上下文验证。
可控夹具使完成顺序固定,因此回归不会因机器速度不同而偶尔通过。deferred 内的非空断言有明确证据:Promise 构造器同步执行赋值,再返回夹具;它不是针对外部数据的无条件断言。请求版本只忽略结果,不取消底层请求。
加载函数的返回类型也不能替代外部值校验。真实网络响应若声称返回字符串或对象,仍要在加载边界检查内容,再交给选择逻辑;竞态保护解决谁可提交,数据校验解决提交的内容是否有效,两者都需要明确入口。
验收同时保留四条输出,才能证明防止旧覆盖、旧错误污染、当前失败遗漏和离开后更新。单独测试两个成功请求还不完整。Promise 调度关系见 MDN Promise,生命周期接入依据 Cocos 3.8 回调。