本地运行React+Firebase7项目报403 PERMISSION_DENIED错误如何解决

基于React、Firebase 7开发的项目本地运行时抛出异常：

FirebaseError: Installations: Create Installation request failed with error "403 PERMISSION_DENIED: The caller does not have permission"

该错误由Firebase Installations服务鉴权失败触发，这个服务负责为每个应用实例生成唯一身份标识，是FCM推送、性能监控、远程配置、A/B测试等Firebase功能的基础依赖，请求被拒绝的常见诱因包括：

• 本地代码中填写的Firebase初始化配置与控制台项目信息不匹配
• 项目绑定的API密钥配置了访问限制，本地调试来源未被加入白名单
• 项目开启Firebase App Check后，本地调试环境未配置合法校验令牌，被拦截
• 绑定的Google Cloud项目中Firebase Installations API被手动禁用
• 本地代理/VPN导致请求源异常，触发Firebase风控拦截
• IAM权限配置错误，匿名调用身份无接口访问权限

• 校验初始化配置：打开项目内Firebase初始化代码文件，逐字段对照Firebase控制台「项目设置 > 常规 > 你的应用」板块下的Web应用配置，重点核对apiKey、projectId、appId三个字段，确认无拼写错误、无多余空格、未混用其他项目的配置。排查阶段可以暂时注释掉FCM、性能监控、远程配置等强依赖Installations的服务，用最小初始化逻辑验证连通性。
• 调整API密钥限制规则：进入Firebase控制台「项目设置 > 常规」板块，找到当前Web应用匹配的API密钥，查看密钥的应用限制规则：如果配置了HTTP引用来源限制，需要将本地调试地址加入白名单，格式参考http://localhost:3000/*（端口替换为本地React项目实际运行端口，末尾通配符*不可省略）；调试阶段可临时将应用限制设置为「无」快速验证问题，上线前再补全安全限制。同时检查密钥的API限制列表，确保Firebase Installations API在允许调用范围内。
• 校验App Check配置：如果项目已接入App Check，先临时注释App Check初始化代码重试，若报错消失则说明是App Check拦截导致。本地调试时需要生成专属调试令牌，在初始化App Check时传入调试令牌，将本地调试环境加入校验白名单即可。
• 确认服务启用状态：进入绑定的Google Cloud项目控制台，搜索Firebase Installations API，确认接口状态为「已启用」，如果处于禁用状态手动启用后等待2分钟左右让配置生效，再重试本地请求。
• 排查本地网络干扰：关闭本地所有代理、VPN工具，清空浏览器对应站点的缓存与本地存储，用浏览器无痕模式运行项目重试，排除插件、网络代理的拦截影响。如果关闭代理后请求恢复正常，将Firebase相关请求域名加入代理直连规则即可。

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