打包参考与验收
本页目录
常见问题速查
按看到的现象查找。每行给出最先要查的地方和详细说明所在页面。表里没有的问题，先按检查整理入口、预期、实际、环境和版本，再定位。
打包、运行与提交
| 现象 |
先查什么 |
详见 |
| 开发服务器正常，导出后白屏 |
相对路径、构建依赖、实际响应头；用 HTTP 运行最终目录而不是 file:// |
打包、打包常见问题 |
| 刷新子页面 404 |
前端路由与静态文件策略 |
前端框架 |
| 上传提示超过容量 |
解开 ZIP 后的总量与单个文件大小，而不是 ZIP 本身大小 |
容量与数量 |
| Godot 编辑器正常，Web 缺脚本或资源 |
显式 export_files 和资源引用；导出退出码为零不代表完整 |
Godot、Godot 导出 |
| 每次重开都重新下载大资源 |
实际传输和缓存；不要给请求加随机时间戳 |
原生网页 |
| 提交说明和包对不上 |
重新构建并核对 SHA256，说明里写清版本和文件名 |
提交 |
登录、资料与存档
| 现象 |
先查什么 |
详见 |
| 登录回来进度没了 |
跳转前是否保存了非敏感选择和恢复点 |
登录与账号 |
| 换了昵称，房间里还是旧的 |
资料快照刷新和组件订阅 |
玩家资料 |
| 换了预览地址，进度消失 |
协议、主机和端口不同就是不同的存储，不是存档丢了 |
存档 |
| 旧进度覆盖了新进度 |
并发写入顺序和版本校验 |
存档 |
| 账号档被游客进度覆盖 |
先读账号档，导入游客进度要用户明确选择 |
存档 |
支付、奖励与广告
| 现象 |
先查什么 |
详见 |
| 显示购买成功却没开局 |
购买和使用是否分开；读取原库存和消费状态 |
支付与权益 |
| 请求超时后多了一笔订单 |
是否把网络重试当成了新购买 |
支付与权益 |
| 登录后自动又买了一次 |
登录成功不等于付款确认；先核对原订单和库存 |
登录与账号 |
| 关掉激励广告也发了奖 |
关闭事件和可信的完成结果要分开 |
激励广告 |
| 刷新后奖励又加了一次 |
回执去重和对应玩法状态是否一起保存 |
激励广告 |
| 没有广告时界面被挡住 |
失败路径是否移除了整个广告容器 |
普通展示广告 |
| 离开后广告又弹出来 |
取消本次展示并丢弃迟到的结果 |
普通展示广告 |
排行榜与联机
| 现象 |
先查什么 |
详见 |
| 点了排行榜没反应 |
弹层是否压在结算页后面，实际点中的是什么 |
排行榜 |
| 刷新时榜单被清空 |
保留已读数据，刷新状态和错误单独显示 |
排行榜 |
| 连上了但不能动 |
加载和开局屏障、输入启用时机、模拟帧是否推进 |
联机制作 |
| 输入有延迟，FPS 却正常 |
输入到画面的时间、确认帧和队列等待 |
双端顺畅游玩验收 |
| 重开后带上了上一局的状态 |
对局代次、序号、旧确认和监听是否清理 |
联机制作 |
AI 生成
| 现象 |
先查什么 |
详见 |
| 回答完了还显示“生成中” |
结束信号和界面状态切换 |
文本生成 |
| 后台显示成功，用户看不到结果 |
任务详情、列表、状态存储和组件订阅，再查渲染和资源权限 |
AI 生成 |
| 生成成功但图片不显示 |
按任务状态、访问授权、下载、解码、组件逐层查，不要直接重新生成 |
图片生成 |
| 换图后用的还是旧审核结果 |
审核结果要绑定被审核内容的标识和摘要 |
内容审核 |
| 重试后重复生成 |
重试只重试原操作，不新建生成 |
内容审核 |
审核与发布
iNeed