游戏引擎 / 系统课时

JSON 数据太大怎么减

JSON 数据太大怎么减

排行榜、队友列表与背包接口可能把完整玩家资料反复发送,而界面只使用其中几个字段。优化应先删掉无关数据与重复结构,再考虑传输压缩和增量更新。本课用可执行代码测量精简前后的 JSON 字节数,同时保留协议可维护性。

学习目标

  • 从字段冗余、重复对象和更新频率定位 JSON 负担。
  • 按页面实际消费字段裁剪响应并计算 UTF-8 大小。
  • 区分结构精简、传输压缩和增量同步的适用边界。

先确认大在哪里

选择一个真机上高频调用的接口,分别记录调用次数、未压缩 JSON 字节数、实际传输字节和解析耗时。如果服务端启用了 gzip 或 br,网络传输字节可能小于 JSON 原文大小,二者不能混为一个指标。单次响应不大,也可能因每秒重复发送而产生明显的流量、CPU 和内存分配成本。

优先检查三类浪费:列表元素反复携带相同的静态描述;客户端已缓存配置,服务器还每次下发整份配置;只渲染生命值却返回昵称、皮肤、等级等完整档案。嵌套层级过深不利于维护,但仅减少括号并不会显著改善网络性能。

从界面消费字段反推协议

例如队友血条只需要 id 和 hp,玩家详情页才需要昵称、等级和皮肤。可把概览响应与详情响应分开,并把静态皮肤信息放入按 ID 索引的本地配置或独立字典。若使用字典,必须定义版本和缺失时的补拉流程,避免客户端查到过期名称。

不要先把 playerId 改成 p、把 health 改成 h。过短字段会增加联调和排障难度,而且重复键名可被压缩算法处理。一般优先减少整个字段或不必要的重复记录,再考虑更紧凑的协议编码。

用代码核算裁剪效果

下面把玩家档案列表裁剪为血条数据。在 Node.js 18+ 或浏览器控制台可直接执行。TextEncoder 计算的是 UTF-8 编码后的原始 JSON 字节数,不包含 HTTP 头,也不等于压缩后的实际传输量。

js
const response = {
  players: [
    { id: 7, name: 'A', level: 12, skin: 'blue', hp: 80 },
    { id: 8, name: 'B', level: 15, skin: 'green', hp: 65 }
  ]
};

// 血条界面只消费标识和当前血量
const compact = {
  players: response.players.map(({ id, hp }) => ({ id, hp }))
};
const bytes = value => new TextEncoder().encode(JSON.stringify(value)).length;
console.log('原始字节:', bytes(response));
console.log('精简字节:', bytes(compact));
console.log('客户端收到:', JSON.stringify(compact));

预期输出:

text
原始字节: 120
精简字节: 47
客户端收到: {"players":[{"id":7,"hp":80},{"id":8,"hp":65}]}

样例的原始 JSON 减少了 73 字节,约 61%。这是小样本的未压缩结果,真实收益还取决于玩家数量、重复字段长度、接口调用频率和压缩率,不能直接照搬这个比例预测整款游戏。

减少重复传输而非只改字段名

方法 主要解决的问题 需要验证
按业务裁剪字段 返回了客户端不使用的数据 所有消费者是否仍有必需字段
gzip 或 br 文本在线上传输时占用字节较多 服务端、客户端支持与解码开销
ETag 与 304 不变资源重复传输完整响应体 缓存键与版本是否正确
版本号加增量列表 高频同步反复发送未变化对象 丢包、漏版本后能否重新全量同步

压缩并不能消除客户端解析大对象的成本;增量包也不应直接替代首次全量快照。二进制序列化可作为后续选项,但涉及协议工具链与版本兼容,只有数据规模和测量结果支持时才值得引入。

兼容性与真机验收

改动字段前,核对服务端、Cocos Creator 客户端的数据类型和旧版本兼容窗口。区分“缺失”“明确为 null”和数值 0:例如 hp 为 0 表示死亡,不能使用 hp || 100 把它误判成满血。增量数据应携带可核对的版本;断线、乱序或版本断层时重新请求完整状态。

在相同设备、网络条件和玩法路径下,对比优化前后的请求频率、原始响应字节、线上传输字节、解析耗时、内存峰值及 UI 显示结果。字段语义清晰且各项指标稳定改善,才算完成 JSON 体积优化。

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

目录与阅读设置

阅读设置

17

记录一个想法

JSON 数据太大怎么减

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

登录哪都通