MAUI应用MSAL登录无令牌返回：交互式登录后代码终止

问题概述 #

开发MAUI应用时，使用MSAL实现企业微软账号登录，登录窗口可正常显示并完成登录操作，但返回主界面后，交互式登录步骤之后的所有代码（包括调试输出语句）均未执行，也无法获取令牌。已完成Azure平台应用注册，重定向URL配置与代码格式一致。

相关代码与配置 #

登录页代码 #

using MSALAuth.MSALClient;
using System.Threading.Tasks;
using static SQLite.SQLite3;
using Microsoft.Identity.Client;
using Microsoft.IdentityModel.Abstractions;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace tefTool
{
    public partial class MainPage : ContentPage
    {
        private const string ClientId = "<ClientID>";
        private const string Tenant = "<TenantID>";
        private static readonly string[] Scopes = { "user.read" };
        private const string Redirect = "msal<ClientID>://auth";
        public static object ParentWindow { get; set; }

        public MainPage()
        {
            InitializeComponent();
        }

        public async void sign(Object sender, EventArgs args)
        {
            Debug.WriteLine("Starting sign-in process...");
            IPublicClientApplication PCA = PublicClientApplicationBuilder
                                            .Create(ClientId)
                                            .WithTenantId(Tenant)
                                            .WithRedirectUri(Redirect)
                                            .WithLogging((level, message, containsPii) =>
                                            {
                                                Debug.WriteLine($"MSAL [{level}]: {message}");
                                            }, LogLevel.Verbose, enablePiiLogging: false, enableDefaultPlatformLogging: true)
                                            .Build();

            var accounts = await PCA.GetAccountsAsync();
            try
            {
                Debug.WriteLine("Attempting silent authentication...");
                var result = await PCA.AcquireTokenSilent(Scopes, accounts.FirstOrDefault()).ExecuteAsync();
                Debug.WriteLine($"Silent authentication successful. Token: {result?.AccessToken}");

                await MainThread.InvokeOnMainThreadAsync(async () =>
                {
                    await DisplayAlert("Login Success", "Login Completed", "Ok");
                    string username = result.Account.Username;
                    await Navigation.PushAsync(new FieldReportPage(username));
                    Navigation.RemovePage(this);
                });

            }
            catch (MsalUiRequiredException)
            {
                Debug.WriteLine("Silent authentication failed, switching to interactive login...");

                var result = await PCA.AcquireTokenInteractive(Scopes)
#if ANDROID
                                    .WithParentActivityOrWindow(Microsoft.Maui.ApplicationModel.Platform.CurrentActivity)
#elif IOS
                                    .WithParentActivityOrWindow(ParentWindow)
#else
                                    .WithParentActivityOrWindow(ParentWindow)
#endif
                                    .WithUseEmbeddedWebView(true)
                                    .WithPrompt(Prompt.SelectAccount)
                                    .ExecuteAsync()
                                    .ConfigureAwait(true);

                Debug.WriteLine($"------------------------------Interactive authentication successful. Token: {result?.AccessToken}");

                await MainThread.InvokeOnMainThreadAsync(async () =>
                {
                    await DisplayAlert("Login Success", "Login Completed", "Ok");
                    string username = result.Account.Username;
                    await Navigation.PushAsync(new FieldReportPage(username));
                    Navigation.RemovePage(this);
                });
            }
            catch (Exception ex)
            {
                Debug.WriteLine($"Error during sign-in: {ex.Message}");
                await MainThread.InvokeOnMainThreadAsync(async () =>
                {
                    await DisplayAlert("Error", $"Sign-in failed: {ex.Message}", "OK");
                });
            }
        }
    }
}

Android清单配置 #

<activity android:name="MauiAppBasic.Platforms.Android.Resources.MsalActivity" android:configChanges="orientation|screenSize" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="msala<ClientID
>" android:host="auth" />
    </intent-filter>
</activity>

问题排查与修复方案 #

1. 修正重定向URL的不一致问题 #

从清单配置可以看到，重定向URL的scheme写成了msala<ClientID>，但代码中是msal<ClientID>，多了一个a，这会导致登录完成后无法正确回调到应用，后续代码自然无法执行。

修改Android清单中的scheme，确保与代码中的Redirect常量完全一致：

<data android:scheme="msal<ClientID>" android:host="auth" />

2. 将异步事件处理方法改为async Task #

使用async void定义事件处理方法时，若发生未捕获异常会直接终止线程，且无法被上层捕获。将sign方法的返回类型改为async Task：

public async Task sign(Object sender, EventArgs args)

MAUI支持将async Task方法直接绑定为按钮点击事件，无需额外修改XAML。

3. 确保MSAL回调Activity配置正确 #

当前清单中MsalActivity的命名空间MauiAppBasic.Platforms.Android.Resources.MsalActivity可能路径错误，建议：

• 若使用最新版MSAL，直接使用官方提供的MsalActivity，无需自定义
• 若手动创建，将Activity放在Platforms.Android目录下，命名空间改为tefTool.Platforms.Android（与项目主命名空间一致）

4. 移除不必要的ConfigureAwait(true) #

交互式登录中ExecuteAsync()后的ConfigureAwait(true)可能引发上下文切换问题，MAUI中无需手动指定，直接调用即可：

var result = await PCA.AcquireTokenInteractive(Scopes)
#if ANDROID
    .WithParentActivityOrWindow(Microsoft.Maui.ApplicationModel.Platform.CurrentActivity)
#elif IOS
    .WithParentActivityOrWindow(ParentWindow)
#else
    .WithParentActivityOrWindow(ParentWindow)
#endif
    .WithUseEmbeddedWebView(true)
    .WithPrompt(Prompt.SelectAccount)
    .ExecuteAsync();

5. 查看MSAL日志定位问题 #

已启用的MSAL日志会输出重定向、回调相关的详细信息，登录完成后检查日志，确认是否存在回调失败、重定向地址不匹配等提示，快速定位根源。

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