iOS应用WebView中Google OAuth出现Disallowed user agent错误的解决方法

问题原因 #

Google OAuth的安全策略会拦截非标准浏览器的User-Agent，iOS的UIWebView/WKWebView默认UA会被识别为嵌入式不安全环境，因此触发Disallowed user agent错误。

解决方法 #

1. 使用AppAuth库（推荐方案） #

这是Google官方推荐的原生OAuth实现方式，通过调用系统SafariViewController或自定义浏览器完成授权，完全避开WebView的UA限制，同时符合OAuth安全规范。

步骤：

• 集成AppAuth库（可通过CocoaPods添加pod 'AppAuth'）
• 在Google Cloud控制台配置客户端ID，设置正确的重定向URI（格式如com.yourapp:/oauth2callback，需与App内配置一致）
• 发起授权请求的示例代码：

import AppAuth

// 配置Google OAuth端点
let issuer = URL(string: "https://accounts.google.com")!
let config = OIDServiceConfiguration(
    authorizationEndpoint: issuer.appendingPathComponent("o/oauth2/v2/auth"),
    tokenEndpoint: issuer.appendingPathComponent("oauth2/v4/token")
)

// 构建授权请求
let authRequest = OIDAuthorizationRequest(
    configuration: config,
    clientId: "你的Google客户端ID",
    scopes: ["openid", "email", "profile"],
    redirectURL: URL(string: "com.yourapp:/oauth2callback")!,
    responseType: OIDResponseTypeCode,
    additionalParameters: nil
)

// 发起授权流程
guard let appDelegate = UIApplication.shared.delegate as? AppDelegate else { return }
appDelegate.currentAuthFlow = OIDAuthState.authState(byPresenting: authRequest, presenting: self) { authState, error in
    if let state = authState {
        // 授权成功，获取访问令牌
        print("Access Token: \(state.lastTokenResponse?.accessToken ?? "")")
    } else {
        print("授权失败：\(error?.localizedDescription ?? "未知错误")")
    }
}

• 在AppDelegate中处理重定向回调：

import AppAuth

var currentAuthFlow: OIDAuthorizationFlowSession?

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    if let flow = currentAuthFlow, flow.resumeAuthorizationFlow(with: url) {
        currentAuthFlow = nil
        return true
    }
    return false
}

2. 替换WebView的User-Agent（临时方案） #

通过修改WebView的UA字符串，伪装成标准Safari浏览器的UA，绕过Google的检测。但此方法存在风险，Google可能随时调整检测逻辑，导致失效。

WKWebView示例代码：

let webConfig = WKWebViewConfiguration()
// 使用对应iOS版本的Safari UA字符串，需根据实际系统版本调整
let safariUA = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1"
webConfig.applicationNameForUserAgent = safariUA
let webView = WKWebView(frame: .zero, configuration: webConfig)

3. 检查Google Cloud控制台配置（辅助验证） #

确保在Google Cloud控制台中，你的客户端ID类型与应用匹配，且已添加正确的授权来源和重定向URI。不过此方法无法从根本解决WebView的UA限制问题，仅作为辅助排查手段。

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