本文要点
- 8 月 28 日起 H5 小游戏不再被接受或支持；9 月 4 日在线 H5 游戏退役；9 月 30 日清理旧 HTML 数据。
- 平台不会自动把网页构建转换成原生包，改文件名、换 URL 或重新压缩都不算迁移。
- 迁移不仅是客户端重建，还要重新验证登录、授权、广告、支付、分享、回访入口和服务端权益。
- 本地存档不会自动出现在原生运行时，必须设计迁移、恢复或重新初始化路径。
- 预览通过不等于生产验收；真实设备、审核包、支付履约和历史权益必须逐项核对。
提交被拒或旧游戏仍能打开，为什么都不能继续等
具体场景是：团队准备修一个 H5 版本，却发现 Developer Portal 出现 sunset 提示或新包无法按旧方式提交；另一边线上游戏暂时还能打开，于是误判为只需延后更新。可见症状可能只是提示与提交失败，真正代价是 9 月 4 日后游戏不可用，以及 9 月 30 日后代码、配置、存档或购买权益所需旧数据无法再取回。
错误直觉是把网页目录重新打 ZIP、改入口名或换一个游戏 URL。正确第一步是建立受影响项目清单并做可验证备份：代码仓库、构建资产、配置、服务端 API、账号映射、存档、订单、余额和已购权益分别记录位置、负责人和恢复测试。
旧规则与新规则：这不是一次普通 SDK 升级
TikTok Minis 过去同时支持在 webview 中运行的 HTML 构建和编译后的 native runtime。官方 2026 年 8 月 28 日文档改为要求所有继续发布或维护的小游戏使用原生运行时，并给出 9 月 4 日退役、9 月 30 日清理旧数据的时间线。
原生小游戏仍运行在 TikTok App 内，不是要求团队另发独立 App；但产物必须通过 Unity、Cocos 或 Laya 等引擎及平台插件导出。标准网站、网页 URL、web build 目录或 HTML ZIP 不能直接上传为原生包，也没有自动转换流程。
迁移前先划清项目、数据和用户责任
适用对象是 TikTok Minis 上现有 HTML 小游戏的开发、发行、支付和运营团队。只使用 TikTok 普通视频、TikTok Shop 或独立网站 H5 的业务，不应把这份 Minis 运行时退役时间线套到自己身上。官方页面没有给出地区例外，因此不要自行假设某站点会延后。
把数据分成三类：可从代码仓库重建的客户端资产；依赖 HTML 本地存储的进度和设置；由服务端账号、订单和权益系统保存的数据。第二类不会自动进入原生环境，第三类必须用稳定的用户映射逐项回读验证。无法证明权益映射正确时，停止上线而不是清空或覆盖旧记录。
从备份到上线的七步执行清单
第一，冻结 H5 项目版本并完成多副本备份。第二，选择受官方指南支持的 Unity、Cocos 或 Laya 路径。第三，用对应插件导出符合目录与包体限制的原生产物。第四，重新接入静默登录、显式授权、广告、内购、分享与回访能力。第五，设计本地存档迁移和服务端账号/权益对账。第六，在 DevTool、真实设备和平台测试环境验证。第七，预留审核时间并在 9 月 4 日前完成生产发布与必要用户通知。
每一步都要有验收记录：构建版本、Client Key、测试账号、设备与 TikTok 客户端版本、接口结果、订单和权益前后值。不要把模拟器、local debug 或 preview 的成功当作生产支付和历史权益已验证。
失败、停手与回滚条件
若原生包出现登录身份错配、旧存档缺失、余额或购买权益不一致、广告奖励重复、支付回调未履约，立即停止扩大流量并保留 H5 与原生两侧的只读证据。不能通过删除用户记录或重复发放来掩盖差异，应由账号、支付和游戏数据负责人共同对账。
回滚条件要在上线前定义，但 9 月 4 日之后不能假设退回 H5 仍可继续运营。可回滚的是新原生版本、功能开关或流量比例；旧 HTML 数据备份必须独立保留。9 月 30 日前再次验证平台外备份可恢复，之后以官方最新文档复查是否有时间线变化。
常见误区与网络边界
误区一是把 sunset 当成性能建议而非强制时间线；误区二是认为平台会自动迁移 IndexedDB 或本地文件；误区三是只验证首屏能打开，不测支付、广告和历史权益；误区四是把审核失败先归因于出口 IP。此次变化与固定出口、IP 归属或代理购买没有直接关系。
只有日志明确显示 DNS、TLS、连接超时或上传链路错误时，才参考<a href="/resources/proxy-connection-troubleshooting-checklist">代理连接排查清单</a>单独验证传输层。包结构、引擎适配、权限、数据迁移和审核结果不会因更换 IP 自动修复；先保存错误码与构建信息，再按官方原生开发指南定位。
资料来源
常见问题
TikTok Minis 什么时候停止支持 HTML/H5 游戏？
官方时间线是 2026 年 8 月 28 日起不再接受或支持 H5，9 月 4 日在线 H5 小游戏退役，9 月 30 日清理旧 HTML 数据。
把 H5 ZIP 重新打包可以变成原生小游戏吗？
不可以。官方明确说明标准网站、URL、web build 目录或 HTML ZIP 不能直接转换；必须用 Unity、Cocos 或 Laya 等支持路径重建并导出原生包。
迁移后用户的本地存档会自动保留吗？
不会自动保留。HTML 环境中的进度、设置和文件需要由游戏实现迁移、恢复或重新初始化，并与服务端账号和权益进行核对。
只要 DevTool 预览通过就能上线吗？
不能。还要完成真实设备、平台测试、审核和生产验证，尤其是登录、广告、支付、历史权益、分享及回访入口。
9 月 4 日后还能回滚到 H5 版本吗？
不应这样规划。官方称在线 H5 游戏届时退役；可设计的是原生版本和流量开关回滚，而不是依赖已退役的 H5 继续运营。
迁移或审核失败时换 IP 有用吗？
对包结构、运行时、权限、数据和审核问题无效。只有错误证据明确指向 DNS、TLS、超时或上传链路时，才需要单独排查网络。