Node + tsx「__name 不是函式」當機

狀態

已解決。此當機問題無法在 package.json 中目前固定的 tsx 版本（4.22.3）或目前的 Node 版本上重現。保留此文件，以備未來升級 tsx/esbuild 時再次引入此問題。

原始症狀

透過 tsx 執行 OpenClaw 開發指令碼時，啟動階段失敗並顯示：

[openclaw] Failed to start CLI: TypeError: __name is not a function    at createSubsystemLogger (src/logging/subsystem.ts)    at <caller> (src/agents/auth-profiles/constants.ts)

此處省略行號；自最初發生當機以來，兩個檔案都已有變更，特定行號已不再對應。

此問題出現在開發指令碼從 Bun 切換至 tsx（2871657e，2026-01-06），以讓 Bun 成為選用項目之後。等效的 Bun 執行路徑並未當機。此問題最初是在 macOS 的 Node v25.3.0 上觀察到；其他執行 Node 25 的平台也被認為可能受到影響。

原因

tsx 透過 esbuild 轉換 TS/ESM，並在其轉換選項中硬式設定 keepNames: true。此設定會讓 esbuild 將具名函式／類別宣告包裝在對 __name 輔助函式的呼叫中，使 fn.name 在最小化與封裝後仍能保留。此當機表示在受影響的 tsx/Node 組合中，該模組的呼叫位置缺少此輔助函式，或該函式遭到遮蔽，因此 __name(...) 並未傳回包裝後的值，而是擲出錯誤。

目前的重現檢查

node --versionpnpm installnode --import tsx src/entry.ts status

最小化的獨立重現方式（僅載入原始堆疊追蹤中的模組）：

node --import tsx scripts/repro/tsx-name-repro.ts

這兩個命令目前都能正常結束。如果其中任一命令再次擲出 __name is not a function，請在向上游回報前，記錄確切的 Node 版本、tsx 版本（node_modules/tsx/package.json）以及完整的堆疊追蹤。

因應措施（若當機問題再次出現）

• 使用 Bun 執行開發指令碼，而不要使用 node --import tsx。

• 執行 pnpm tsgo 進行型別檢查，然後執行建置後的輸出，而不是透過 tsx 執行原始碼：

  pnpm tsgonode openclaw.mjs status

• 嘗試不同的 tsx 版本（pnpm add -D tsx@<version> 屬於相依套件變更，依儲存庫政策需要核准），以二分查找其內含的 esbuild 版本是否再次引入此錯誤。

• 在不同的 Node 主版本／次版本上測試，以確認此失敗是否僅發生於特定版本。

參考資料

• https://esbuild.github.io/api/#keep-names
• https://github.com/evanw/esbuild/issues/1031

相關內容

• Node.js 安裝
• 閘道疑難排解