Firebase模拟器--inspect-functions报错及VS Code调试失败求助

核心问题定位 #

你看到的警告--inspect-functions only supported for Node.js runtimes是关键线索：当前你的Firebase Functions运行时并非Node.js，导致--inspect-functions参数无法生效，进而VS Code调试器无法稳定附着。

具体修复步骤 #

1. 确认Functions运行时配置 #

检查项目根目录的firebase.json文件，确保functions字段指定了Node.js运行时：

{
  "functions": {
    "runtime": "nodejs18", // 可替换为nodejs20等官方支持的Node.js版本
    // 其他配置...
  }
}

如果之前修改过运行时（比如切换到Python/Java），改回Node.js即可消除警告。

2. 验证CLI版本兼容性 #

老旧版本的Firebase CLI可能存在调试参数的兼容性问题，升级到最新稳定版：

npm install -g firebase-tools

3. 调整调试附着时机 #

启动模拟器后，等待终端输出functions emulator started at http://localhost:5001这类日志，确认Functions服务完全启动后，再在VS Code中触发调试附着操作，避免因服务未就绪导致调试器断开。

4. 优化launch.json配置（可选） #

你的launch.json配置本身无问题，但如果Functions代码不在项目根目录，可增加localRoot字段确保路径映射正确：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Debug",
      "restart": true,
      "port": 9229,
      "localRoot": "${workspaceFolder}/functions" // 替换为你的Functions代码目录
    }
  ]
}

内容的提问来源于stack exchange，提问作者Schotti100