ASWebAuthenticationSession实现OAuth授权码流程重定向失败排查

你的核心问题是：ASWebAuthenticationSession 无法捕获 OAuth 服务返回的 myapp://auth#code=<something> 回调跳转，导致认证窗口不关闭、无法回到应用，而手动访问该 Scheme URL 是正常的。以下是针对性的排查和解决步骤：

1. 修正窗口上下文获取逻辑 #

iOS 13+ 引入了 Scene 架构，原有的 UIApplication.shared.windows.first! 可能在多窗口、后台恢复等场景下返回错误或空窗口，导致 ASWebAuthenticationSession 无法正确绑定上下文，进而影响回调触发。替换为基于 Scene 的窗口获取方式：

class PresentationContextProvider: NSObject, ASWebAuthenticationPresentationContextProviding {
    func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor {
        guard let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
              let window = scene.windows.first else {
            return ASPresentationAnchor()
        }
        return window
    }
}

2. 排查 OAuth 回调 URL 的格式问题 #

ASWebAuthenticationSession 对带 Fragment（# 后的内容） 的自定义 Scheme URL 支持存在限制：

• OAuth 授权码流程的规范中，code 通常通过 Query 参数（而非 Fragment）传递；
• 部分场景下，Safari 视图容器会拦截带 Fragment 的 Scheme 跳转，无法触发 ASWebAuthenticationSession 的回调逻辑。

解决方式： #

方案A：调整服务端回调格式

要求 OAuth 服务端将 code 放在 Query 参数中，返回的 302 Location 改为：

myapp://auth?code=<something>

方案B：通过中间页面转换 Fragment

如果无法修改服务端，可以让服务端 302 到一个静态 HTML 页面，通过 JS 提取 Fragment 中的 code 并重新跳转到不带 Fragment 的 Scheme URL：

<script>
const hashParams = new URLSearchParams(window.location.hash.slice(1));
const code = hashParams.get('code');
window.location.href = `myapp://auth?code=${code}`;
</script>

3. 清理冗余的 Scheme 配置 #

你的 info.plist 中存在一个空的 <dict/> 节点，虽然不影响功能，但建议删除以保持配置整洁：

<dict>
    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleTypeRole</key>
            <string>Editor</string>
            <key>CFBundleURLName</key>
            <string>com.abc.def</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>myapp</string>
            </array>
        </dict>
    </array>
</dict>

4. 可选：添加 Session 代理监听错误 #

iOS 16+ 可以实现 ASWebAuthenticationSessionDelegate 来获取更详细的错误信息，排查回调失败原因：

extension AContentView: ASWebAuthenticationSessionDelegate {
    func authenticationSession(_ session: ASWebAuthenticationSession, didCompleteWithError error: Error) {
        print("Session error detail: \(error)")
    }
}

// 在 authenticate() 方法中设置代理
authSession?.delegate = self

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