Firebase functions serve异常：Emulator UI启动失败报错求助

问题现象 #

Firebase functions serve突然停止正常运行，抛出错误：

⚠  ui: Fatal error occurred:  Emulator UI has exited with code: 1,

对应的日志信息：

/Users/maz/.cache/firebase/emulators/ui-v1.11.7/server/server.js:3292
    "chars": "\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uFFFD\uF
                                                                                                                                                                                                              ^^^^

SyntaxError: Invalid Unicode escape sequence
    at Object.compileFunction (node:vm:360:18)
    at wrapSafe (node:internal/modules/cjs/loader:1126:15)
    at Module._compile (node:internal/modules/cjs/loader:1162:27)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1252:10)
    at Module.load (node:internal/modules/cjs/loader:1076:32)
    at Function.Module._load (node:internal/modules/cjs/loader:911:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    at node:internal/main/run_main_module:22:47

已尝试重装Node.js、Firebase Tools、清理缓存、重启电脑等操作，问题仍未解决，需恢复正常运行状态。

修复步骤 #

• 彻底清理损坏的UI缓存文件
  手动删除已损坏的UI缓存目录，强制重新下载完整资源：

  rm -rf /Users/maz/.cache/firebase/emulators/ui-v1.11.7
  firebase emulators:start --force
  

• 切换到兼容的Node.js LTS版本
  部分Node.js版本与当前UI版本存在兼容性问题，建议使用LTS版本（如v18或v20）：

  # 若已安装nvm，切换到v20版本
  nvm install 20
  nvm use 20
  # 重启模拟器
  firebase emulators:start
  

• 降级Firebase Tools到稳定版本
  当前UI版本v1.11.7可能存在已知bug，降级到经过验证的稳定版本：

  npm install -g firebase-tools@12.9.1
  firebase emulators:start --clear-cache
  

• 检查项目配置文件编码
  确认项目根目录下的firebase.json、.firebaserc等配置文件无乱码或损坏的Unicode字符，若存在异常，重新生成配置文件后再启动模拟器。

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