Cocos Creator 3.8.7 构建的抖音小游戏,在开启抖音引擎插件(引擎分离) 的情况下,安卓和iOS真机报错 Can't find module cocos/2d.js,但鸿蒙系统真机正常,且抖音开发者工具正常。全量包(关闭引擎分离)在所有平台均正常。
复现条件
项目 | 信息 |
|---|---|
Cocos Creator 版本 | 3.8.7 |
构建平台 | 抖音小游戏 |
引擎设置 | 启用抖音引擎插件(分离引擎)= ✅ 开启 |
原生代码分包 | Wasm/Asmjs = ❌ 未开启 |
抖音客户端版本 | 40.2.0 |
开发者工具版本 | 4.5.4 / 4.5.5 |
异常现象
- 错误信息(真机日志):
- text
- USER_RESOLVE_MODULE_ERROR: Can't find module cocos/2d.js at resolve (ttjssdk:///tmg-core.js:2:723798) at a (ttjssdk:///tmg-core.js:2:728386) ...
- 真机平台差异:安卓系统:❌ 报错iOS系统:❌ 报错鸿蒙系统(HarmonyOS 7):✅ 正常抖音开发者工具:✅ 正常
- 全量包(关闭引擎分离):安卓/iOS/鸿蒙全部 ✅ 正常
关键时间节点
2026年8月27日下午开始出现此问题。
此前已正常上线发布的历史包(引擎分离方案),在未做任何代码或配置修改的情况下,直接重新提交也会触发同样的报错。这表明问题可能源于平台侧(抖音开放平台或抖音客户端)的策略/机制调整,而非项目工程本身的变化。
问题优先级
- 当前阻塞了所有使用引擎分离方案的抖音小游戏的正常发版
- 影响平台:安卓、iOS(覆盖绝大多数用户)
- 临时绕行方案:关闭引擎分离打全量包(会导致主包体积增大)
