MAUI Android应用Azure交互式登录异常问题排查

问题描述 #

MAUI版本应用中Azure登录功能失效，但已稳定运行4年的Xamarin版本可正常使用。MAUI执行Azure登录流程时，从未出现应用选择提示（Xamarin版本最后一步会提示选择“仅一次”或“始终”），直接跳转回应用且未获取到Token。

登录流程代码 #

try
{
    AuthResult = await PCA.AcquireTokenInteractive(_scopes)
        .WithAuthority(AUTHORITY_URI)
        .WithParentActivityOrWindow(theParentWindow)
        .WithPrompt(Prompt.ForceLogin)
        .ExecuteAsync();

}
catch (Exception ex2)
{
    SetAuthToken(null);
    throw new ApplicationException("Interactive login failed", ex2);
}

SetAuthToken(AuthResult?.AccessToken);

Xamarin版本AndroidManifest配置 #

<application android:label="Our App" android:icon="@drawable/Logo_Sized" android:debuggable="true" android:networkSecurityConfig="@xml/network_security_config">
    <activity android:name="microsoft.identity.client.BrowserTabActivity" android:configChanges="orientation|screenSize">
        <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="msal5af1aeaa-5a52-4699-8273-ec10b68ebfb2" android:host="auth" />
        </intent-filter>
    </activity>
    <provider android:name="android.support.v4.content.FileProvider" android:authorities="com.company.ourapp.fileprovider" android:exported="false" android:grantUriPermissions="true">
        <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"></meta-data>
    </provider>
</application>

MAUI版本AndroidManifest配置 #

<application android:allowBackup="true" android:icon="@mipmap/app_logo" android:supportsRtl="true" android:label="Our App" android:usesCleartextTraffic="true" android:debuggable="true">
    <activity android:name="microsoft.identity.client.BrowserTabActivity" 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="msal5af1aeaa-5a52-4699-8273-ec10b68ebfb2" android:host="auth" />
        </intent-filter>
    </activity>
    <provider android:name="androidx.core.content.FileProvider" android:authorities="com.company.ourapp.fileprovider" android:exported="false" android:grantUriPermissions="true">
        <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"></meta-data>
    </provider>
</application>

排查方向 #

1. 网络安全配置缺失 #

Xamarin版本配置了android:networkSecurityConfig="@xml/network_security_config"，但MAUI版本未添加。该配置允许应用与Azure AD认证端点安全通信，缺失可能导致回调Intent无法正常传递。建议在MAUI的AndroidManifest中添加该配置，并确保network_security_config.xml文件存在且配置正确。

2. Parent Activity传递正确性 #

MAUI中WithParentActivityOrWindow的参数传递逻辑与Xamarin不同。需确认theParentWindow是否为当前有效的Activity实例，在MAUI Android中应使用Platform.CurrentActivity获取当前Activity，替代Xamarin的旧方式。

3. MSAL版本兼容性 #

检查Xamarin与MAUI使用的MSAL NuGet包版本是否一致。MAUI若使用了更新的MSAL版本，可能存在API行为变化，需对应调整代码或配置。建议优先对齐版本，若需升级则参考MSAL官方迁移文档调整。

4. 浏览器选择与Intent处理 #

MAUI中MSAL的浏览器选择逻辑可能默认使用嵌入式WebView，而非系统浏览器，因此不会触发应用选择提示。可尝试在登录代码中添加.WithUseEmbeddedWebView(false)强制使用系统浏览器，观察是否出现选择提示并正常获取Token。

5. 日志分析定位问题 #

添加MSAL verbose日志记录，捕获登录过程中的详细错误信息：

var PCA = PublicClientApplicationBuilder.Create("your-client-id")
    .WithLogging((level, message, containsPii) =>
    {
        System.Diagnostics.Debug.WriteLine($"MSAL Log: [{level}] {message}");
    }, Microsoft.Identity.Client.LogLevel.Verbose)
    .WithAuthority(AUTHORITY_URI)
    .Build();

通过日志查看回调Intent是否被正确接收、是否有认证错误返回，进一步定位失效原因。

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