Bug 反馈:抖音小游戏开发者工具对"函数内 async 函数"转译后丢失闭包
90 浏览2026年08月03日作者:h01w

环境

  • 抖音开发者工具版本:4.5.5
  • 小游戏基础库 / tmg-core 版本:4.19.0.2
  • 平台:抖音小游戏(模拟器复现,真机预计同样受影响)
  • 复现形态:PuerTS/Unity WebGL 小游戏,业务代码经工具二次转译

复现步骤

  1. 在某个 class 的 constructor 内声明一个 async function,函数体访问 constructor 的局部变量(const/let)
  2. 将函数注册为按钮回调
  3. 点击按钮触发该函数

最小复现代码:

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 转译提升逻辑。

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

相关问答

专题推荐

热门文章

热门问答