游戏引擎 / 系统课时

定位异步竞态和旧数据覆盖

定位异步竞态和旧数据覆盖

玩家先选角色 A 再选 B,A 的慢请求最后完成,却把界面换回旧角色。代码没有类型错误,单次测试也可能正常。本节用可控完成顺序重现竞态,以请求版本控制结果提交,并同时验证旧成功、旧失败、当前失败与界面失效。

学习目标

  • 从启动顺序和完成顺序识别异步竞态。
  • 保证只有当前有效请求更新数据与错误状态。
  • 通过可控 Promise 复现边界,而不依赖随机延迟。

请求开始顺序不决定完成顺序

两次请求都可以正确完成,问题出在“谁拥有当前显示”。当需求是最后一次选择优先时,每次选择递增版本,完成时仅当前版本允许提交。旧失败也必须忽略,否则旧请求的错误会把新成功显示改成失败。

busy 适合拒绝重复提交,版本号适合允许新选择覆盖旧选择,两者目标不同。若使用同一个共享 loading 标记,旧请求的 finally 也可能把新请求仍在加载的状态清掉。状态清理同样需要归属检查,而不是只保护数据赋值。

新旧请求完成顺序

用可控完成顺序验证提交

文件:main.ts,完整纯 TypeScript 主例程。deferred 是可手动结束的真实 Promise 夹具,不使用随机定时器。

ts
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; });

预期输出:

text
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 回调。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位异步竞态和旧数据覆盖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通