iOS应用Firebase API Key受限致请求被拒，求排查原因

核心问题原因 #

错误提示"Requests from this iOS client application <empty> are blocked"说明Google服务器未接收到应用的Bundle ID，触发了API Key的iOS应用限制拦截，主要原因如下：

1. 模拟器环境兼容性问题 #

Firebase SDK在部分模拟器版本或旧SDK版本中，无法正确将Bundle ID传递给Google验证服务器，导致服务器识别不到客户端身份，直接拦截请求——这是模拟器特有的环境问题，真机通常不会出现。

2. API Key配置细节错误 #

• 限制类型与服务不匹配：确认Google Cloud Console的API Key配置中，选择的是「iOS应用」限制类型，且在「限制对以下API的访问」列表中明确添加了Identity Toolkit API（对应错误里的identitytoolkit.googleapis.com服务），若未添加该服务，即便Bundle ID正确也会被拦截。
• Bundle ID匹配偏差：需确保添加的Bundle ID是完全复制Xcode项目中的值（含正确大小写、无多余空格），手动输入易出现拼写错误；同时检查是否误加无关Bundle ID导致匹配逻辑冲突。

3. Firebase SDK配置或缓存问题 #

• 配置文件不一致：核对GoogleService-Info.plist中的API_KEY值，是否和Cloud Console中设置了Bundle ID限制的API Key完全一致，避免用错未加限制的Key或旧Key。
• 配置变更缓存延迟：Google Cloud的API Key配置变更通常需要15-30分钟生效，刚修改完就测试可能遇到缓存导致的拦截。
• 旧SDK Bug：旧版本Firebase Auth SDK存在模拟器下Bundle ID传递的Bug，更新到最新版本可解决这类问题。

解决步骤 #

1. 优先测试真机：直接在真机上运行应用测试手机号登录功能，验证是否为模拟器环境导致的问题。
2. 核对API Key配置：
   • 进入Google Cloud Console的API Keys页面，找到对应Key，确认限制类型为「iOS应用」，Bundle ID完全匹配Xcode项目值。
   • 确保「API限制」中勾选了Identity Toolkit API。
3. 清理项目与缓存：
   • 在Xcode中执行Product > Clean Build Folder清理编译缓存。
   • 删除模拟器中的应用，重新安装后测试。
4. 更新Firebase SDK：通过CocoaPods或Swift Package Manager将Firebase相关依赖（尤其是FirebaseAuth）更新到最新版本。

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