TestFlight/App Store环境下Google登录功能异常问题求助

问题根源 #

出现disallowed_useragent或回调无响应，核心原因是：

• Google OAuth不识别PWA Builder包装器的WebView用户代理，判定为非授权客户端
• 包装器的WebView配置未适配Google登录的跳转、存储需求
• TestFlight/App Store版本的沙箱环境和Safari/主屏幕PWA的运行环境存在差异

具体修复步骤 #

1. 统一WebView用户代理 #

修改Swift包装器的WebView初始化代码，将用户代理设置为与Safari一致的格式，避免被Google拦截：

let webConfig = WKWebViewConfiguration()
// 替换为对应iOS版本的Safari用户代理，可在Safari中通过navigator.userAgent获取
let safariUserAgent = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1"
webConfig.applicationNameForUserAgent = safariUserAgent
let webView = WKWebView(frame: .zero, configuration: webConfig)

2. 配置Google OAuth客户端 #

在Google Cloud控制台的OAuth 2.0客户端设置中：

• 添加iOS应用的Bundle ID作为授权来源（对应Xcode项目的Bundle Identifier）
• 确保已添加PWA的回调URI（如https://your-app-domain.com/auth/callback）到Web应用的授权回调列表中

3. 拦截并处理登录回调跳转 #

包装器的WebView默认可能不会正确处理Google登录后的回调跳转，需添加导航拦截逻辑：

extension YourViewController: WKNavigationDelegate {
    func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
        guard let url = navigationAction.request.url else {
            decisionHandler(.allow)
            return
        }
        // 匹配你的Google登录回调URL前缀
        if url.absoluteString.hasPrefix("https://your-app-domain.com/auth/callback") {
            webView.load(URLRequest(url: url))
            decisionHandler(.allow)
            return
        }
        decisionHandler(.allow)
    }
}

同时在初始化WebView时设置navigationDelegate：

webView.navigationDelegate = self

4. 启用WebView的必要权限 #

确保WebView配置支持JavaScript、Cookie存储，保证登录状态正常流转：

webConfig.preferences.javaScriptEnabled = true
webConfig.preferences.javaScriptCanOpenWindowsAutomatically = true
webConfig.websiteDataStore = WKWebsiteDataStore.default()

5. 适配App Store沙箱环境 #

在Info.plist中添加必要配置：

• 确保NSAppTransportSecurity允许HTTPS访问（正式环境必须启用，无需例外）
• 若使用自定义URL Scheme，需在CFBundleURLTypes中添加对应的Scheme（如果回调使用Scheme跳转）

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