Google OAuth2/Firebase登录授权成功后无法重定向至PWA构建的iOS原生应用

核心原因 #

这类问题本质是iOS原生容器的URL Scheme或通用链接配置不匹配，导致Google授权完成后无法正确唤起你的应用。Web环境的重定向逻辑在原生容器中需要额外配置支撑，否则会卡在加载界面。

具体修复步骤 #

1. 核对URL Scheme配置 #

• 在Google Cloud控制台的OAuth 2.0客户端ID设置里，确认已添加iOS应用对应的URL Scheme，格式为com.googleusercontent.apps.{{你的客户端ID}}
• 用PWA Builder打包时，务必在iOS配置项中填入这个Scheme；如果已经打包完成，可直接在生成的Xcode项目的Info.plist里，在CFBundleURLTypes数组中手动添加该Scheme

2. 验证通用链接（若启用） #

• 若你的应用用了Universal Links，要确保：
  • Google Cloud控制台的授权重定向URI包含你的通用链接（比如https://你的域名.com/__/auth/handler）
  • 你的域名已正确配置Apple App Site Association文件，且关联了打包后iOS应用的Bundle ID
  • PWA Builder打包时已开启Universal Links并填入正确域名

3. 调整Firebase登录的回调处理 #

• 使用signInWithRedirect时，必须在应用启动阶段就处理重定向回调，不能等用户点击登录后才初始化：

  // 应用启动时立即执行
  firebase.auth().getRedirectResult()
    .then((result) => {
      if (result.user) {
        // 执行登录成功后的逻辑
      }
    }).catch((error) => {
      // 处理授权错误
    });
  

4. 检查iOS容器的WebView权限 #

• PWA Builder打包的iOS应用默认用WKWebView，需确保WebView允许外部跳转并正确处理重定向：
  • 在Xcode项目中检查WKWebViewConfiguration的权限设置是否合理
  • 确认实现了WKNavigationDelegate的webView:decidePolicyForNavigationAction:decisionHandler:方法，允许跳转至accounts.google.com及重定向回应用的Scheme/通用链接

5. 调试回调逻辑 #

• 在重定向URI对应的页面添加日志，确认是否被正常访问；如果iOS容器里没触发，说明重定向未被正确处理
• 用Safari的Web Inspector调试打包后的应用，查看控制台是否有重定向相关的错误信息

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