TTSDK 6.8.0 转换产物 wr 对象字段缺失
262 浏览2026年08月10日作者:User7667851651321659446


> 标题建议:TTSDK 6.8.0 转换产物 webgl.framework.js 中 wr 对象字段缺失,Unity 2022.3 UnityWebRequest 首次调用即崩溃

---

## 一、问题现象

在抖音开发者平台/真机运行时,游戏内第一次发起 `UnityWebRequest` 即抛出异常,网络请求全部不可用:

```

tmg-core.js:1 [TMG] TypeError: at requestAnimationFrame callback

Cannot set properties of undefined (setting '1')

at _JS_WebRequest_Create(webgl.framework.js? [sm]:10)

```

- 触发代码为游戏内任意 `UnityWebRequest.Get/Post`(例如 `RequestMgr.cs`、`MusicLoadingManager.cs` 中的请求)。

- 报错发生在 Unity 主循环(requestAnimationFrame 回调)中,属于运行时 JS 桥崩溃,C# 侧无法捕获。

## 二、复现步骤

1. Unity 2022.3.62f3c1 项目接入 TTSDK 6.8.0。

2. 使用 TTSDK 转换工具(wasm 分包新方案)构建并转换输出抖音小游戏工程。

3. 在开发者工具/真机上启动游戏,触发任意 `UnityWebRequest` 请求。

4. 控制台出现上述 TypeError,请求链路中断。

## 三、环境信息

| 项 | 值 |

| --- | --- |

| Unity 版本 | 2022.3.62f3c1 (1623fc0bbb97) |

| TTSDK 版本 | 6.8.0(package.json 确认) |

| 转换工具 | ttsdk_tools.dll(Editor/Tool/ttsdk_tools.dll) |

| 打包方案 | wasm 分包(subpackages: wasmcode/、data-package/) |


## 四、问题定位与根因分析

### 4.1 崩溃点

转换产物 `tt-minigame/webgl.framework.js` 第 10 行(压缩后):

```js

var wr=Module.StarkWR={requestInstances:{},nextRequestId:1,loglevel:2};

function _JS_WebRequest_Abort(requestId){var abortController=wr.abortControllers[requestId];...}

function _JS_WebRequest_Create(url,method){...;wr.abortControllers[wr.nextRequestId]=abortController;wr.requests[wr.nextRequestId]=requestOptions;return wr.nextRequestId++}

```

`_JS_WebRequest_Create` 为 Unity 2022.3 新版 WebRequest 的 JS 桥,其依赖 `wr.abortControllers`、`wr.requests`,后续 `_JS_WebRequest_Send/_Release/_GetResponseMetaData` 还依赖 `wr.responses`、`wr.timer`。

而 `wr` 被改写为 `Module.StarkWR={requestInstances:{},nextRequestId:1,loglevel:2}`,**上述 4 个字段全部缺失**。`nextRequestId` 从 1 开始,因此第一次请求执行 `wr.abortControllers[1]=...` 时即抛出 `Cannot set properties of undefined (setting '1')`,与线上报错一字不差。

### 4.2 证据:转换前字段完整

同一 Unity 版本、同一项目,未经过 TTSDK 转换的编辑器手动 WebGL 构建(`build/WebGL_Douyin/Build/WebGL_Douyin.framework.js`),其定义为:

```js

var wr={requests:{},responses:{},abortControllers:{},timer:{},nextRequestId:1};

```

同一套 `_JS_WebRequest_*` 函数在此对象下运行正常,说明问题不在 Unity 引擎,而是 TTSDK 转换流程改写所致。

### 4.3 改写来源

- 项目内 jslib/C# 源码中不存在 `StarkWR`、`requestInstances` 相关定义(已在 `Assets/Plugins/ByteGame/com.bytedance.starksdk/WebGL` 下全量检索)。

- `Module.StarkWR` 结构(`requestInstances/nextRequestId/loglevel`)与框架内旧版 `_XHR_*` 系列函数匹配,疑似转换工具将 `wr` 整体替换为给 UnityPlugin 接管用的对象,但未保留新版 `_JS_WebRequest_*` 所需字段。

- 结论:此为 TTSDK 转换工具(6.8.0)对 Unity 2022.3 新版 WebRequest 的兼容性缺陷。

### 4.4 推测(待官方确认)

TTSDK 的设计意图可能是让平台端 UnityPlugin 在运行时接管 `_JS_WebRequest_*`(基于 `Module.StarkWR.requestInstances` 走 `tt.request`)。若实际加载的 UnityPlugin 版本与 game.json 指定的 4.38.0 不一致(本机 IDE 缓存中仅发现 4.19.0.2 / base-3.43.0.12),插件不会接管,原版函数被直接调用从而崩溃。

## 五、临时规避方案(已本地验证)

每次转换后,将 `tt-minigame/webgl.framework.js` 中:

```js

var wr=Module.StarkWR={requestInstances:{},nextRequestId:1,loglevel:2};

```

替换为(补回 4 个字段,兼容插件接管与框架自带 fetch 实现两条路径):

```js

var wr=Module.StarkWR={requestInstances:{},nextRequestId:1,loglevel:2,requests:{},responses:{},abortControllers:{},timer:{}};

```

已提供一键补丁脚本 `Assets/Editor/patch-tt-webrequest.ps1`(幂等、自动备份、写入后校验),经测试可正确修复且不影响 JS 语法。

## 六、期望的官方修复

1. 转换工具在改写 `wr` 时保留 `requests/responses/abortControllers/timer` 四个字段(兼容 Unity 2022.3 新版 WebRequest)。

2. 或确保 UnityPlugin 在运行时完整接管 `_JS_WebRequest_*` 系列函数,并保证 game.json 指定的插件版本能被正确加载。

3. 建议增加转换选项/日志,便于定位此类框架改写问题。

## 七、相关文件

- 转换产物:`tt-minigame/webgl.framework.js`(第 10 行)

- 转换工具:`Assets/Plugins/ByteGame/com.bytedance.starksdk/Editor/Tool/ttsdk_tools.dll`

- 模板配置:`Assets/Plugins/ByteGame/com.bytedance.starksdk/DefaultTemplate/game.js`

- 构建设置:`Assets/Editor/StarkBuilderSetting.asset`

- 一键补丁:`Assets/Editor/patch-tt-webrequest.ps1`

---

*以上内容基于实际打包产物与源码比对得出,供官方复现与定位参考。*

最后一次编辑于 2026 年 08 月 11 日
共 1 条评论

相关问答

专题推荐

热门文章

热门问答