启动Firebase Functions本地模拟器时遭遇“command requires scopes”权限范围错误

你遇到的这个TypeError: Cannot read properties of undefined (reading 'source')错误确实挺棘手，尤其是之前一直正常运行的情况下。除了重新登录账号，这里还有几个可以尝试的排查和解决方法：

1. 清理Firebase模拟器缓存 #

Firebase模拟器的缓存可能出现损坏，导致启动异常。执行以下命令清理缓存：

firebase emulators:exec "rm -rf ~/.cache/firebase/emulators"

或者手动找到缓存目录~/.cache/firebase/emulators，删除里面的所有内容，然后再尝试启动模拟器。

2. 更新firebase-tools到最新版本 #

旧版本的firebase-tools可能存在已知bug，更新到最新版往往能解决这类问题：

npm install -g firebase-tools@latest

更新完成后，再运行firebase emulators:start --only functions --debug试试。

3. 检查firebase.json配置文件 #

确认你的firebase.json中关于functions模拟器的配置是否正确，有没有遗漏或错误的字段。比如确保emulators.functions部分的配置是合理的，示例：

{
  "emulators": {
    "functions": {
      "port": 5001
    }
  }
}

如果配置有问题，尝试恢复到之前能正常运行的版本，或者重新生成默认配置。

4. 重新初始化Firebase项目的functions部分 #

有时候项目的本地配置文件可能损坏，可以尝试重新初始化functions：

firebase init functions

注意选择保留现有的函数代码（如果不想覆盖的话），重新生成相关配置文件后再启动模拟器。

5. 检查Node.js版本兼容性 #

虽然你用的是Node v16.15.0，这个版本理论上和firebase-tools兼容，但可以尝试切换到其他稳定版本（比如v18的LTS版本），用nvm快速切换：

nvm install 18
nvm use 18

然后重新安装firebase-tools并尝试启动模拟器。

6. 重置Firebase登录的本地凭据 #

除了登出重新登录，还可以彻底清除本地的Firebase凭据，然后重新登录：

firebase logout --token
firebase login

这会强制刷新本地的认证令牌，解决可能的权限或令牌过期问题。

7. 检查项目权限配置 #

虽然你已经登录，但可以确认当前账号对目标Firebase项目是否有足够的权限。访问Firebase控制台，进入项目设置 -> 权限，检查你的账号是否拥有「Firebase Admin」或「Editor」角色，确保权限范围包含报错信息里提到的那些scopes。

8. 重新安装项目依赖 #

进入你的functions目录，删除node_modules和package-lock.json（或yarn.lock），然后重新安装依赖：

cd functions
rm -rf node_modules package-lock.json
npm install

依赖损坏也可能导致模拟器启动时出现异常。

如果以上方法都试过还是不行，可以尝试创建一个新的测试Firebase项目，初始化functions并启动模拟器，看是否能正常运行，以此排查是不是当前项目的配置问题。

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