MAUI WebAuthenticator取消授权流程致应用崩溃问题求助

问题根源 #

调试模式下异常能被捕获，但发布版崩溃，核心原因是平台底层抛出的取消类异常未被当前catch块覆盖，或异步上下文导致异常未被正确捕获。

具体修复方案 #

1. 扩展异常捕获范围 #

将原有的TaskCanceledException捕获扩展为包含平台特定的取消异常，同时处理可能的包装类异常：

try
{
    authResult = await WebAuthenticator.Default.AuthenticateAsync(
        new WebAuthenticatorOptions()
        {
            Url = new Uri(ivs_auth_broker),
            CallbackUrl = new Uri(Constants.Android.RedirectUri),
            PrefersEphemeralWebBrowserSession = true
        }).ConfigureAwait(true); // 明确绑定UI线程上下文，确保异常被正确捕获

    code = authResult?.Properties["code"];
    if (string.IsNullOrEmpty(code))
    {
        Debug.Fail("OAuth code not received.");
        return false;
    }
    else
    {
        return await exchangeCodeForTokens(
            GoogleAuthConsts.TokenUrl,
            authResult!.Properties["code"],
            Constants.Android.ClientId,
            Constants.Android.RedirectUri);
    }
}
catch (TaskCanceledException)
{
    return false;
}
catch (OperationCanceledException) // 捕获Android平台抛出的取消异常
{
    return false;
}
catch (AggregateException ex) // 处理被包装的取消异常
{
    if (ex.InnerException is TaskCanceledException || ex.InnerException is OperationCanceledException)
    {
        return false;
    }
    return false;
}
catch // 兜底捕获所有未处理异常
{
    return false;
}

2. Android平台特定处理 #

在MainActivity中重写OnNewIntent，确保WebAuthenticator的取消回调被正确拦截：

protected override void OnNewIntent(Intent intent)
{
    base.OnNewIntent(intent);
    // 手动处理WebAuthenticator的跳转回调，避免异常扩散
    if (WebAuthenticator.Default.CheckRedirectIntent(intent))
    {
        return;
    }
}

3. iOS平台特定处理 #

在AppDelegate中重写OpenUrl方法，确保取消时的URL被正确处理：

public override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options)
{
    if (WebAuthenticator.Default.CheckRedirectUri(url))
    {
        // 拦截WebAuthenticator的跳转事件，避免未处理异常
        return true;
    }
    return base.OpenUrl(app, url, options);
}

4. 验证Ephemeral会话设置 #

PrefersEphemeralWebBrowserSession在iOS上会启用隐私模式浏览器，部分场景下取消流程的异常抛出逻辑会变化。可以临时关闭该选项验证是否解决崩溃，再针对性调整。

关键说明 #

发布版中，.NET的异常捕获机制可能因JIT优化或平台底层异常包装，导致原有的TaskCanceledException无法覆盖所有取消场景，必须扩展捕获范围；平台特定的回调处理能确保WebAuthenticator的生命周期事件被正确拦截，避免未处理异常导致应用崩溃。

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