Firebase AppCheck iOS生成AppCheck令牌时报错 错误码为0

常见根因排查步骤 #

• 校验Firebase控制台配置：确认当前应用Bundle ID已在Firebase控制台开启AppCheck服务，且对应iOS平台的校验提供商配置正确。debug环境下需要将当前测试的iPhone 12设备UDID添加到AppCheck的测试设备列表，避免正式校验不通过。
• 检查Xcode项目能力配置：打开项目的Signing & Capabilities标签页，确认已添加DeviceCheck能力，缺少该系统能力会直接导致底层校验接口调用失败，返回无描述的0错误。
• 确认调用时序合规：AppCheck.appCheck().token(forcingRefresh: false)的调用必须在FirebaseApp.configure()执行完成后触发，不要在application(_:didFinishLaunchingWithOptions:)生命周期中过早调用，建议延后到主UI加载完成后再执行首次Token请求。

Debug环境临时验证方案 #

可通过开启AppCheck本地调试提供商，快速定位是否为设备校验链路导致的问题，该配置仅可在测试环境使用，禁止打包到生产环境：

#if DEBUG
let debugProviderFactory = AppCheckDebugProviderFactory()
AppCheck.setAppCheckProviderFactory(debugProviderFactory)
#endif

FirebaseApp.configure()

详细错误获取方式 #

在Xcode的Scheme启动参数中添加-FIRDebugEnabled参数，重新运行应用后查看控制台输出的Firebase全量日志，即可获取错误码0对应的底层具体报错信息，进一步定位配置遗漏项。

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