环境
- 抖音开发者工具版本:4.5.5
- 小游戏基础库 / tmg-core 版本:4.19.0.2
- 平台:抖音小游戏(模拟器复现,真机预计同样受影响)
- 复现形态:PuerTS/Unity WebGL 小游戏,业务代码经工具二次转译
复现步骤
- 在某个 class 的 constructor 内声明一个 async function,函数体访问 constructor 的局部变量(const/let)
- 将函数注册为按钮回调
- 点击按钮触发该函数
最小复现代码:
class Foo {
constructor() {
const input = getInput(); // constructor 局部变量
async function onClick() {
const text = input.text; // 访问外层局部变量
const r = await doFetch(text);
return r.ok;
}
btn.onClick(onClick); // 注册回调
}
}
期望行为
点击按钮后函数正常执行,闭包变量 input 可访问。
实际行为
点击按钮即抛错,控制台输出:
[TMG] ReferenceError: e is not defined
at ?(eval (ui_feedback_detail.ts:73)
at step(puerts_minigame_js_resources/main/ui_feedback_detail-CmwJUku_.js:234)
at Object.eval [as next](puerts_minigame_js_resources/main/ui_feedback_detail-CmwJUku_.js:175)
at asyncGeneratorStep(puerts_minigame_js_resources/main/ui_feedback_detail-CmwJUku_.js:11)
at _next(puerts_minigame_js_resources/main/ui_feedback_detail-CmwJUku_.js:29)
根因分析(附转译产物证据)
工具在加载时对模块代码做二次转译(Babel 风格,asyncGeneratorStep / _async_to_generator / _ts_generator)。转译器把函数内部声明的 async 函数的转译产物 _l 提升到了模块顶层,脱离了原所在函数(constructor)作用域,导致 generator body 中对外层局部变量的引用全部变成未定义引用。
有问题的转译产物(还原后):
class J extends C {
constructor() {
var l = function l() { return _l.apply(this, arguments); }; // 包装函数留在 constructor 内
var e = inputDescription; // constructor 局部变量
...
}
}
function _l() { // ← 被提升到模块顶层!
_l = _async_to_generator(function() {
return _ts_generator(this, function(_state) {
switch (_state.label) {
case 0:
o = e.text; // ← 引用 constructor 局部 e,但此处 e 不在作用域 → ReferenceError
...
对照:模块顶层声明的 async 函数(不依赖外层局部变量)转译后正常;函数内 async 仅访问 this 也正常(this 经 apply 传入)。只有"函数内 async 函数 + 访问外层局部变量"这一组合会触发。
附带影响
- 不是个例:项目中有多个"函数/方法内嵌套 async function"的文件在抖音环境存在同类风险
- 微信开发者工具无此问题(整包转译逻辑不同)
临时规避(供参考)
在喂给工具前,先用 esbuild 以 supported: { 'async-await': false } 转译,把 async/await 降级为 generator + 内联 helper(esbuild 不提升函数、闭包保持),产物无 async 关键字,工具不再走该转译路径即可绕开。这进一步证明问题出在工具的 async 转译提升逻辑。
