Xamarin Android集成MSAL认证成功后卡在回调页，需缩放/横屏触发继续按钮

问题现象 #

• MSAL认证流程已成功完成并获取令牌，但应用卡在回调页面，无法自动返回
• 仅执行以下操作后，页面才会显示“继续”按钮：
  • 手动缩放页面
  • 将设备切换至横屏模式
• 点击“继续”按钮后，认证流程才可正常完成并回调至应用
• 该问题仅在部分Android设备上出现

问题截图说明 #

• 图1：回调页面无“继续”按钮，页面显示异常
• 图2：缩放页面后，“继续”按钮正常显示
• 图3：横屏模式下，弹窗及“继续”按钮正常显示

可能的解决方案 #

1. 升级MSAL包至最新稳定版 #

旧版本Microsoft.Identity.Client可能存在Android UI适配bug，通过NuGet包管理器或命令行升级：

Install-Package Microsoft.Identity.Client -Version [最新稳定版本号]

2. 调整回调Activity的主题配置 #

部分设备系统主题与MSAL页面样式冲突，在AndroidManifest.xml中为BrowserTabActivity指定兼容主题：

<activity
    android:name="microsoft.identity.client.BrowserTabActivity"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar" />

也可自定义主题并引用，确保主题包含必要窗口属性：

<!-- 在styles.xml中添加 -->
<style name="MSALCallbackTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowActionBar">false</item>
    <item name="android:windowFullscreen">false</item>
</style>

3. 配置MSAL的UI参数 #

初始化PublicClientApplication时，指定UIParent并调整行为参数：

var uiParent = new UIParent(this, true);
var pca = PublicClientApplicationBuilder
    .Create("你的ClientId")
    .WithRedirectUri($"msal你的ClientId://auth")
    .Build();

var authResult = await pca.AcquireTokenInteractive(new[] {"scope1", "scope2"})
    .WithUIParent(uiParent)
    .WithPrompt(Prompt.SelectAccount)
    .ExecuteAsync();

4. 切换WebView实现方式 #

MSAL依赖系统WebView，旧版本WebView可能存在渲染问题，可切换至Chrome自定义Tabs：

var pca = PublicClientApplicationBuilder
    .Create("你的ClientId")
    .WithRedirectUri($"msal你的ClientId://auth")
    .WithUseEmbeddedWebView(false) // 使用系统浏览器/Chrome自定义Tabs
    .Build();

同时引导用户更新设备的Android System WebView至最新版本。

5. 确保回调事件正确处理 #

在MainActivity中正确重写OnActivityResult，保证MSAL能接收回调参数：

protected override void OnActivityResult(int requestCode, Result resultCode, Intent data)
{
    base.OnActivityResult(requestCode, resultCode, data);
    AuthenticationContinuationHelper.SetAuthenticationContinuationEventArgs(requestCode, resultCode, data);
}

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