游戏引擎 / 系统课时
弱网下加载怎样不中断
弱网下加载怎样不中断
移动游戏在地铁、信号切换或短时断网时,活动公告和远程图片可能长时间卡住。本课把可选加载改成有超时、有限重试和兜底数据的链路,并说明如何保留下载进度,使网络失败不再阻塞主要玩法。
学习目标
- 区分必须成功的在线操作与允许降级的可选内容。
- 为幂等读取请求实现超时、退避重试和失败兜底。
- 判断分页和大文件何时可以从续点恢复。
先决定什么不能阻塞玩法
进入本地关卡需要的场景、脚本与碰撞数据应随包提供或在进入前明确校验;活动入口、推荐列表、头像等可选在线内容可以晚到,超时后显示已有缓存或默认占位。这样玩家不会因为一张活动图加载失败而一直看着转圈动画。
但登录鉴权、付费结果、背包交易等涉及权威状态的操作不能伪装成成功。它们失败时应提示失败或限制相应功能,而不是用旧缓存覆盖服务端真实状态。应先给每种请求标注“关键”或“可选”,再决定能否降级。
把超时、重试与降级接成有限状态
一次可选请求从“发起”进入“等待”,收到有效数据即提交;网络断开、超时、HTTP 408、429 或 5xx 才进入有限次重试。退避等待可采用逐次增长的间隔,并增加少量随机抖动,避免大量客户端同一时刻重连。普通 4xx 不应反复请求。

每条请求都必须有退出条件:单次超时、最大尝试次数、可接受的总等待时间,以及过期回调不得覆盖较新的请求结果。服务器返回 Retry-After 时应遵守其限流建议,而不是机械地立即重试;非幂等写入只有在服务端支持幂等键时才适合自动重试。
用可运行示例复现弱网
以下示例在 Node.js 18+ 可直接运行。它通过注入传输函数模拟前两次返回 503、第三次成功,以及持续离线;真实 Web 业务请求省略第三个参数即可使用 fetch。250ms 只是演示超时值,不能照搬为生产环境参数。
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)));预期输出:
{"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 资源缓存不等于业务层自动具备任意字节断点续传能力。
用三种故障完成验收
分别模拟高延迟与丢包、加载中断网、恢复网络后重进场景。检查等待动画是否按时退出、重试次数是否受限、默认内容是否可见,以及恢复后是否只提交一次有效结果。记录请求标识、尝试次数、失败类型和是否降级,不在日志中写入令牌。合格的实现不是所有请求都成功,而是失败被限定在可控范围内,主要玩法仍可响应。