SwiftUI iOS集成Stripe Onboarding：重定向检测方案咨询

问题背景 #

我正在SwiftUI iOS应用中集成Stripe Connect Onboarding，需要用户完成Stripe登录后返回应用。服务器已配置两个HTTPS重定向地址用于成功和刷新事件：

https://example.com/onboarding/callback?stripe_return=true
https://example.com/onboarding/callback?stripe_refresh=true

尝试过的方案 #

1. WKWebView #

伪代码示例：

let url: URL  
var onNavigation: (URL?) -> Void

func makeUIView(context: Context) -> WKWebView {
  let webview = WKWebView()
  webview.navigationDelegate = context.coordinator
  webview.load(URLRequest(url: url))
  return webview
}
// … coordinator调用onNavigation(webview.url) …

结果：Stripe界面无法加载（仅白屏），疑似因第三方Cookie、JS上下文隔离或机器人防护被WKWebView拦截，已放弃。

2. SFSafariViewController #

伪代码示例：

let safari = SFSafariViewController(url: URL(string: accountLinkUrl)!)
present(safari, animated: true)

结果：Stripe UI加载正常，但无法监听URL变化以响应成功/刷新事件（SFSafariViewController代理不暴露中间重定向）。

3. SFSafariViewController + Universal Links #

已为https://example.com/onboarding/callback配置关联域名与AASA文件，但SFSafariViewController内的自动重定向（302或JS触发）无法唤起应用的Universal Links。

4. SFSafariViewController + 自定义URL Scheme #

尝试将Stripe的return_url设为myapp://onboarding?stripe_return=true等，但Stripe生产环境拒绝非HTTPS地址，提示“return_url必须为HTTPS”。

官方推荐方案：iOS 17.4+的ASWebAuthenticationSession #

iOS 17.4及以上版本的ASWebAuthenticationSession支持HTTPS回调匹配器，可完美解决该问题，运行正常。

SwiftUI适配代码示例 #

import SwiftUI
import AuthenticationServices

struct StripeOnboardingView: View {
    let accountLinkUrl: URL
    let callbackUrlPrefix = "https://example.com/onboarding/callback"
    
    @State private var isPresentingAuthSession = false
    
    var body: some View {
        Button("开始Stripe入驻") {
            isPresentingAuthSession = true
        }
        .fullScreenCover(isPresented: $isPresentingAuthSession) {
            // 会话结束后的清理逻辑
        } content: {
            ASWebAuthenticationSessionView(
                url: accountLinkUrl,
                callbackURLScheme: nil,
                callbackURLPrefix: callbackUrlPrefix
            ) { callbackUrl, error in
                isPresentingAuthSession = false
                
                guard let callbackUrl = callbackUrl else {
                    // 处理错误或用户取消操作
                    return
                }
                
                // 解析回调参数，区分事件类型
                let components = URLComponents(url: callbackUrl, resolvingAgainstBaseURL: false)
                let isSuccess = components?.queryItems?.contains(where: { 
                    $0.name == "stripe_return" && $0.value == "true" 
                }) ?? false
                let isRefresh = components?.queryItems?.contains(where: { 
                    $0.name == "stripe_refresh" && $0.value == "true" 
                }) ?? false
                
                if isSuccess {
                    // 执行成功入驻后的业务逻辑
                } else if isRefresh {
                    // 执行刷新后的业务逻辑
                }
            }
        }
    }
}

// 将ASWebAuthenticationSession封装为SwiftUI View
struct ASWebAuthenticationSessionView: UIViewControllerRepresentable {
    let url: URL
    let callbackURLScheme: String?
    let callbackURLPrefix: String
    let completionHandler: (URL?, Error?) -> Void
    
    func makeUIViewController(context: Context) -> ASWebAuthenticationSession {
        let session: ASWebAuthenticationSession
        if #available(iOS 17.4, *) {
            session = ASWebAuthenticationSession(
                url: url,
                callbackURLPrefix: callbackURLPrefix,
                completionHandler: completionHandler
            )
        } else {
            // 低版本兼容逻辑（可选）
            session = ASWebAuthenticationSession(
                url: url,
                callbackURLScheme: callbackURLScheme,
                completionHandler: completionHandler
            )
        }
        session.presentationContextProvider = context.coordinator
        return session
    }
    
    func updateUIViewController(_ uiViewController: ASWebAuthenticationSession, context: Context) {}
    
    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }
    
    class Coordinator: NSObject, ASWebAuthenticationPresentationContextProviding {
        let parent: ASWebAuthenticationSessionView
        
        init(parent: ASWebAuthenticationSessionView) {
            self.parent = parent
        }
        
        func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor {
            return UIApplication.shared.windows.first ?? ASPresentationAnchor()
        }
    }
}

核心说明 #

• iOS 17.4新增的callbackURLPrefix参数支持HTTPS前缀匹配，无需依赖自定义URL Scheme，完全符合Stripe对return_url必须为HTTPS的要求。
• 会话结束后可直接解析回调URL的查询参数，精准区分成功/刷新事件，无缝衔接SwiftUI视图流程。

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