ASWebAuthenticationSession重定向行为不一致，登录状态同步异常求助

核心问题梳理 #

• 应用通过WKWebView加载支持Google、Microsoft、DLRG登录的网站，使用ASWebAuthenticationSession完成认证流程
• 关键异常：弹窗内登录成功，但关闭弹窗后WKWebView回到登录页面，登录状态无法延续；设备表现不一致——iPhone 11仅Google登录异常，iPhone 13则时好时坏
• 附加问题：配置Associated Domains的applinks通用链接后，自定义callbackURLScheme被忽略，仅点击弹窗取消按钮时触发回调；正常场景下通过SwiftUI的.onOpenURL接收重定向URL完成登录，异常时该方法无响应

排查思路 #

• 会话隔离问题：代码中设置了prefersEphemeralWebBrowserSession = true，这个参数会让ASWebAuthenticationSession使用临时浏览器会话，与WKWebView的常规会话完全隔离，临时会话的Cookie不会持久化到App的WKWebView存储中，这是登录状态无法延续的核心原因之一。
• Applinks与URL Scheme冲突：配置applinks后，认证服务的重定向请求可能优先匹配通用链接规则，绕过ASWebAuthenticationSession的callbackURLScheme回调逻辑，直接触发App的通用链接处理流程，如果.onOpenURL的处理逻辑有遗漏，就会导致无响应。
• iOS版本差异：不同iPhone型号对应的iOS版本不同，ASWebAuthenticationSession在iOS 14+版本中对会话隔离、通用链接优先级的处理有调整，iPhone 13搭载的iOS版本通常较新，可能触发了不同的底层逻辑。
• WKWebView Cookie同步逻辑：即使不使用临时会话，也需要确保认证后的Cookie能正确同步到WKWebView的WKHTTPCookieStore中，否则WKWebView无法读取登录状态。

解决方案 #

1. 调整临时会话配置
   把prefersEphemeralWebBrowserSession设为false，让ASWebAuthenticationSession使用App共享的浏览器会话，这样认证后的Cookie会与WKWebView共享，关闭弹窗后WKWebView能直接读取到登录状态：

   session?.prefersEphemeralWebBrowserSession = false
   

   注意：如果业务对隐私要求较高，需要评估该设置的影响，但这是解决状态不延续最直接的方案。

2. 处理Applinks与自定义URL Scheme的冲突

   • 在认证请求的重定向URL中，明确指定使用自定义URL Scheme（如com.my.app://auth-callback），避免认证服务返回通用链接格式的重定向地址，防止被applinks拦截。
   • 确保App的Info.plist中正确配置了URL Types，将com.my.app添加到URL Schemes列表中。
   • 如果必须使用通用链接作为重定向地址，需要在Associated Domains的配置中，针对认证回调的路径添加例外规则，确保ASWebAuthenticationSession能正确捕获回调。

3. 手动同步Cookie（保留临时会话场景）
   如果需要保留prefersEphemeralWebBrowserSession = true，可以在认证成功回调中提取凭证，手动同步到WKWebView：

   • 从callbackURL中解析出认证token或会话信息，通过WKWebView的evaluateJavaScript方法将凭证注入页面Cookie，或者调用后端接口让WKWebView重新获取登录状态。
   • 示例代码（注入Cookie）：

     if let callbackURL = callbackURL {
         let token = callbackURL.queryParameters?["token"] ?? ""
         let cookieScript = "document.cookie = 'auth_token=\(token); path=/; domain=your-domain.com';"
         webView.evaluateJavaScript(cookieScript) { result, error in
             // 处理注入结果
         }
     }
     

4. 完善.onOpenURL处理逻辑
   确保.onOpenURL接收到重定向URL后，正确传递给WKWebView加载，并且WKWebView使用默认的网站数据存储：

   .onOpenURL { url in
       // 确认URL是认证回调地址
       if url.scheme == "com.my.app" {
           webViewModel.webView.load(URLRequest(url: url))
       }
   }
   

   同时检查WKWebView的配置：

   let configuration = WKWebViewConfiguration()
   // 使用默认存储，不要使用临时存储
   configuration.websiteDataStore = WKWebsiteDataStore.default()
   let webView = WKWebView(frame: .zero, configuration: configuration)
   

5. 跨iOS版本测试验证
   在不同iOS版本的设备或模拟器上测试，确认异常是否属于版本特定问题，针对对应版本调整代码逻辑。比如iOS 16+对ASWebAuthenticationSession的回调处理有细微调整，可能需要额外的适配。

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