游戏引擎 / 系统课时

弱网下加载怎样不中断

弱网下加载怎样不中断

移动游戏在地铁、信号切换或短时断网时,活动公告和远程图片可能长时间卡住。本课把可选加载改成有超时、有限重试和兜底数据的链路,并说明如何保留下载进度,使网络失败不再阻塞主要玩法。

学习目标

  • 区分必须成功的在线操作与允许降级的可选内容。
  • 为幂等读取请求实现超时、退避重试和失败兜底。
  • 判断分页和大文件何时可以从续点恢复。

先决定什么不能阻塞玩法

进入本地关卡需要的场景、脚本与碰撞数据应随包提供或在进入前明确校验;活动入口、推荐列表、头像等可选在线内容可以晚到,超时后显示已有缓存或默认占位。这样玩家不会因为一张活动图加载失败而一直看着转圈动画。

但登录鉴权、付费结果、背包交易等涉及权威状态的操作不能伪装成成功。它们失败时应提示失败或限制相应功能,而不是用旧缓存覆盖服务端真实状态。应先给每种请求标注“关键”或“可选”,再决定能否降级。

把超时、重试与降级接成有限状态

一次可选请求从“发起”进入“等待”,收到有效数据即提交;网络断开、超时、HTTP 408、429 或 5xx 才进入有限次重试。退避等待可采用逐次增长的间隔,并增加少量随机抖动,避免大量客户端同一时刻重连。普通 4xx 不应反复请求。

弱网请求的重试与降级状态图

每条请求都必须有退出条件:单次超时、最大尝试次数、可接受的总等待时间,以及过期回调不得覆盖较新的请求结果。服务器返回 Retry-After 时应遵守其限流建议,而不是机械地立即重试;非幂等写入只有在服务端支持幂等键时才适合自动重试。

用可运行示例复现弱网

以下示例在 Node.js 18+ 可直接运行。它通过注入传输函数模拟前两次返回 503、第三次成功,以及持续离线;真实 Web 业务请求省略第三个参数即可使用 fetch。250ms 只是演示超时值,不能照搬为生产环境参数。

js
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function loadOptionalJson(url, fallback, transport = fetch) {
  const maxAttempts = 3;
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const controller = new AbortController();
    const timer = setTimeout(() => controller.abort(), 250);
    try {
      const response = await transport(url, { signal: controller.signal });
      if (response.ok) {
        const data = await response.json();
        return { data, attempts: attempt, fromFallback: false };
      }
      // 非暂时性 HTTP 错误不继续重试
      const retryable = [408, 429].includes(response.status) || response.status >= 500;
      if (!retryable) return { data: fallback, attempts: attempt, fromFallback: true };
    } catch (error) {
      // JSON 格式错误不是网络抖动
      if (error instanceof SyntaxError) {
        return { data: fallback, attempts: attempt, fromFallback: true };
      }
    } finally {
      clearTimeout(timer);
    }
    if (attempt < maxAttempts) await sleep(40 * 2 ** (attempt - 1));
  }
  return { data: fallback, attempts: maxAttempts, fromFallback: true };
}

let calls = 0;
const unstable = async () => {
  calls++;
  if (calls < 3) return { ok: false, status: 503 };
  return { ok: true, json: async () => ({ notice: '新活动已开放' }) };
};
const offline = async () => { throw new TypeError('offline'); };
const fallback = { notice: '暂无公告' };

console.log(JSON.stringify(await loadOptionalJson('/notice', fallback, unstable)));
console.log(JSON.stringify(await loadOptionalJson('/notice', fallback, offline)));

预期输出:

text
{"data":{"notice":"新活动已开放"},"attempts":3,"fromFallback":false}
{"data":{"notice":"暂无公告"},"attempts":3,"fromFallback":true}

fromFallback 应驱动界面显示“当前为缓存或默认内容”,避免把旧公告当作最新数据。此封装针对可选 JSON 业务读取;Cocos Creator 3.8 的远程资源应继续走 assetManager。其下载器支持 maxRetryCount 和 retryInterval,不要再叠加一套无限的业务重试。

让恢复从有效进度开始

分页内容可在一页成功校验并落盘后保存游标、版本和已处理记录;重连只请求下一页。未完成的一页不更新游标,否则可能遗漏数据。切换账号或数据版本后,应使旧游标失效。

大文件续传则需要服务端支持 HTTP Range,并用 ETag 与 If-Range 确保文件版本一致。只有收到符合预期区间的 206 Partial Content 才能拼接已校验字节;返回 200 应丢弃旧分块、重新完整下载,遇到 416 也应检查文件长度与版本。Cocos 资源缓存不等于业务层自动具备任意字节断点续传能力。

用三种故障完成验收

分别模拟高延迟与丢包、加载中断网、恢复网络后重进场景。检查等待动画是否按时退出、重试次数是否受限、默认内容是否可见,以及恢复后是否只提交一次有效结果。记录请求标识、尝试次数、失败类型和是否降级,不在日志中写入令牌。合格的实现不是所有请求都成功,而是失败被限定在可控范围内,主要玩法仍可响应。

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

目录与阅读设置

阅读设置

17

记录一个想法

弱网下加载怎样不中断

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

登录哪都通