云存档、排行榜与游戏安全
适用:引擎无关的数据权威与安全设计;微信 API 示例按官方类型资料核对,Cocos Creator 3.8.8 为客户端接入目标。资料核查:2026-11-17。
云上保存不等于可信
“存在云端”只描述数据放在哪里,不说明谁有资格写、写入值如何验证。客户端若能把金币从一百改成一百万再上传,云存档会非常可靠地保存作弊结果。先把偏好设置、单机进度、竞争成绩和经济资产分开:音量可以客户端直接保存,跨设备关卡进度需要冲突策略,排行和交易资产需要可信规则。一个 JSON 文档承载所有数据,会把最宽松字段的权限带给最敏感字段。
微信好友关系相关云存储与自己的业务数据库也不是同一系统。官方类型中存在 setUserCloudStorage 等接口,但接口可用不代表它适合做游戏经济账本。涉及好友排行与开放数据域的权限、展示与数据流,应按平台当前文档实现;跨游戏全服排名、异常成绩处理和永久背包仍应有自己的服务端设计。
先设计冲突,不要最后覆盖
云存档至少带 schemaVersion、revision、updatedAt 和必要的内容版本。客户端提交自己基于哪个 revision 修改,由服务端做条件更新;冲突时返回当前状态,按字段语义合并。设置可采用最后修改策略,但“较新”必须定义可信时钟;离线解锁的普通关卡可做集合并集,消耗道具则不能简单取最大值。一个总分最大值策略也可能绕过消耗与领取次数。
type Save = {
schemaVersion: 2;
revision: number;
unlockedLevels: string[];
settings: { music: boolean };
};
type SaveWrite = { baseRevision: number; settings: { music: boolean } };
// 服务端条件更新 revision = baseRevision;成功后递增。
// 背包、购买和奖励不通过这个通用存档接口写入。
内容升级会改变关卡标识、任务字段和奖励规则,迁移应可重跑且保留回退所需信息。先对旧存档样本运行迁移,再验证新客户端能读取、旧客户端会被合理拒绝或兼容。不要让客户端遇到未知版本就默认空存档并上传,这会把一次兼容性问题变成永久数据丢失。
排行榜的输入必须有来源链
排行榜记录除了分数,还应能定位局标识、规则版本、完成时间与验证状态。服务端可检查一次局是否有资格提交、时长是否合理、输入是否超出上限、成绩是否与已知规则矛盾。对于高价值排名,考虑服务端模拟或重放验证;对于轻量活动,异常检测与人工复核可能更经济。检测阈值属于风险取舍,不能把“低于阈值”当作合法证明。
离线单机上传成绩尤其需要明确可信程度。可以标注为未验证排行、限制奖品价值,或先验证再进入正式排名。客户端混淆、代码加密、请求签名有一定逆向成本收益,但客户端里携带的密钥无法成为长期保密的可信根。攻击者控制运行环境时,能观察调用和重放合法请求;服务端必须校验业务前置条件。
云函数也要面对游戏特定滥用
把逻辑放进云函数能改变部署方式,不能替代授权和经济约束。每次请求从可信认证上下文解析用户,不接受 body.userId 决定归属;读取记录也要检查所有者。限制消息长度、请求频率与并发,避免有人用巨量动作和大数组放大计算开销。限流可按账号、会话、操作类型和局阶段组合,单一 IP 容易误伤同网玩家。
运行时校验要覆盖数值有限性:NaN、Infinity、负数、超大整数、越界枚举、异常坐标都可能破坏模拟。网络协议允许的字符串不应直接用作文件路径、资源 URL 或数据库查询片段。资源下载限定可信域与版本清单,避免任意 URL 让客户端加载错误内容。服务端返回的文本同样需要按展示组件的能力处理。
最小化秘密与可关联数据
客户端代码、构建产物、Source Map 和资源配置都可被分析,不能放 AppSecret、数据库凭据或后台管理令牌。服务端凭据按环境隔离,轮换时考虑旧进程仍在使用;日志记录业务标识、阶段与错误码,避免输出完整登录材料。可用散列或内部匿名标识做关联,但散列本身并不自动意味着无法识别个人。
采集游戏行为只保留支持诊断与运营决策所必需的字段,明确用途、留存与访问范围。哪些数据需要何种告知、同意、备案或未成年人处理,属于当前地区与平台政策核验事项,本节不代替法律判断。上线前应拿实际数据清单去核对官方规范与项目责任人,而不是把通用隐私模板贴上就认为完成。
从症状回到信任边界
玩家报告存档回退时,查 revision 冲突、离线覆盖、迁移默认值和多设备写入,不应立即把 CDN 缓存当作原因。排行突然暴涨时,先看规则版本和成绩来源,再看是否存在重复结算或客户端可写字段;合法数值配置错误也会造成异常。安全日志要能还原动作链,但不要在正式日志保存全部触摸轨迹和个人资料而没有必要性。
测试环境应提供可控账号与伪造输入入口;正式环境关闭调试加币接口。发布前扫描构建包中的密钥样式和测试地址,并审查云端权限。扫描只能发现一部分问题,仍要验证“甲玩家能否读取或修改乙玩家数据”以及“同一局能否无限领奖”等业务性质。
交给 AI 的任务与验收
可复制任务:“设计设置云存档与服务端背包的分离模型。存档实现 revision 条件更新、版本迁移与冲突返回;排行提交绑定局标识和规则版本。增加跨用户访问、负数货币、重复领奖、未知存档版本的拒绝或恢复路径。列出每个字段的权威与敏感等级。”
验收两个设备并发修改不会无声覆盖;旧存档迁移可重跑;改变客户端余额字段不能改账本;甲账号无法访问乙账号;构建包不含平台密钥。把可验证的业务约束写成测试,比单纯增加客户端签名更能说明系统边界。
官方来源与限制
- 微信官方 API 类型仓库:setUserCloudStorage 等接口,核查提交 42c427aa8c3961b7a4f8ea5bd6112c2bcf058177;平台数据权限须另核当前官方文档。
- OWASP WebSocket Security:连接鉴权、输入限制和日志控制。
- PostgreSQL 事务隔离:并发更新的数据库基础;本节字段划分与游戏威胁模型为课程工程建议。