.NET MAUI Android端WebAuthenticator回调后代码不执行问题

排查方向及解决步骤 #

1. 检查AndroidManifest.xml的Intent过滤配置 #

确保MainActivity中添加了与回调URL匹配的Intent过滤规则，配置需完全对应：

<activity android:name=".MainActivity">
    <!-- 其他原有配置 -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 替换为你的回调URL的scheme，例如回调是myapp://auth则填myapp -->
        <data android:scheme="your-app-scheme" />
    </intent-filter>
</activity>

注意：scheme必须与代码中callbackUrl的scheme完全一致，区分大小写。

2. 调整Activity启动模式 #

不要将Activity的android:launchMode设置为singleInstance，该模式会导致重定向的Intent无法将认证结果传递回原任务实例。建议使用默认的standard模式，或显式声明：

<activity android:name=".MainActivity" android:launchMode="standard">

3. 添加异常捕获排查隐藏错误 #

在认证代码块外包裹try-catch，捕获可能的未处理异常（如state验证失败、参数解析错误等），这类异常会直接终止后续代码执行：

try
{
    WebAuthenticatorResult result = null;
    var authUrl = new Uri($"{authUrlRoot}{scheme}");
    var callbackUrl = new Uri($"{callback}");

    result = await WebAuthenticator.Default.AuthenticateAsync(authUrl, callbackUrl);

    var authToken = string.Empty;
    if (result.Properties.TryGetValue("name", out string name) && !string.IsNullOrEmpty(name))
        authToken += $"Name: {name}{Environment.NewLine}";
    if (result.Properties.TryGetValue("email", out string email) && !string.IsNullOrEmpty(email))
        authToken += $"Email: {email}{Environment.NewLine}";
    authToken += result?.AccessToken ?? result?.IdToken;
    
    await ToastAsync("returned successfully");
}
catch (Exception ex)
{
    await ToastAsync($"认证异常：{ex.Message}");
}

4. 验证Web端重定向的正确性 #

• 确保Web应用重定向的URL与代码中callbackUrl完全一致，需完整返回WebAuthenticator自动生成的state参数。
• 检查重定向URL是否存在特殊字符或编码错误，避免Android无法正确解析。

5. 升级.NET MAUI版本 #

部分旧版本的.NET MAUI（如7.x早期版本）存在WebAuthenticator在Android端的兼容性bug，升级到最新稳定版（如.NET 8或最新.NET 7补丁版）可解决此类问题。

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