.NET MAUI 10应用中Entra ID登录浏览器卡顿问题求助

• 检查MAUI平台的WebAuthenticator配置
  .NET MAUI 10对WebAuthenticator的回调处理有明确要求，需确保各平台配置正确：

  • Android：在Platforms/Android/AndroidManifest.xml中添加对应回调URL的intent-filter，替换{你的ClientId}为实际Entra ID客户端ID：

    <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="msal{你的ClientId}" />
    </intent-filter>
    

  • iOS：在Platforms/iOS/Info.plist中添加URL scheme：

    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>msal{你的ClientId}</string>
            </array>
        </dict>
    </array>
    

  注意MSAL要求回调scheme必须以msal开头拼接客户端ID。

• 升级MSAL至适配.NET 10的版本
  v4.81.0可能存在.NET 10兼容性问题，建议升级到最新稳定版（如v4.90.0及以上）。执行以下NuGet命令更新：

  Uninstall-Package Microsoft.Identity.Client
  Install-Package Microsoft.Identity.Client -Version 4.90.0
  

• 切换至嵌入式WebView
  默认使用的系统浏览器可能存在跨进程缓存或兼容性问题，尝试启用MSAL的嵌入式WebView：

  var pca = PublicClientApplicationBuilder.Create(clientId)
      .WithRedirectUri($"msal{clientId}://auth")
      .WithEmbeddedWebView()
      .Build();
  

  嵌入式WebView能避免系统浏览器的跳转异常，大概率解决加载卡住的问题。

• 验证Entra ID应用注册配置

  • 确认应用注册的重定向URI已正确设置为msal{你的ClientId}://auth，且归类在"移动和桌面应用"平台下。
  • 检查已添加的API权限（如User.Read）是否为委托权限，且已完成管理员同意（租户级应用需此步骤）。

• 排查网络与权限问题

  • 测试设备能否正常访问https://login.microsoftonline.com/，若存在代理环境，需确保MAUI应用配置了正确的代理规则。
  • Android平台需在AndroidManifest.xml中添加必要的网络权限：

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    

• 启用MSAL日志定位问题
  开启MSAL调试日志，查看登录流程中的具体错误：

  var pca = PublicClientApplicationBuilder.Create(clientId)
      .WithRedirectUri($"msal{clientId}://auth")
      .Build();
  
  pca.AddDebugCallback(logMessage =>
  {
      System.Diagnostics.Debug.WriteLine(logMessage);
  });
  

  通过输出窗口的日志信息，可定位请求失败、重定向异常等核心问题。

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