Android MSAL多应用监听URL Scheme报错，求SSO兼容解决方案

AI 小北

2026-7-24

解决Android MSAL系统浏览器SSO的URL Scheme冲突问题

问题本质

你遇到的MsalClientException是因为默认的msauth URL Scheme被Chrome注册了（Chrome内置支持微软账户SSO，所以也监听了这个scheme），导致多个应用争抢同一个scheme的跳转请求。结合你的需求——保留系统浏览器SSO+授权后跳转客户官网，按以下步骤解决：

解决方案步骤

1. 定义唯一的自定义URL Scheme

放弃默认的msauth，用一个和你应用绑定的独特scheme，比如com-yourcompany-appid-auth（只要保证不会和其他应用重复就行）。

2. 修正AndroidManifest中的BrowserTabActivity配置

修改BrowserTabActivity的intent-filter，替换scheme为自定义值，同时path要和后续Azure配置的重定向URI对应，还要包含正确的租户ID：

<activity
    android:name="com.microsoft.identity.client.BrowserTabActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 替换成你的自定义scheme、租户ID -->
        <data
            android:scheme="com-yourcompany-appid-auth"
            android:host="login.microsoftonline.com"
            android:path="/你的租户ID/oauth2/nativeclient" />
    </intent-filter>
</activity>

3. 更新MSAL配置文件（auth_config.json）

修改redirect_uri为自定义scheme对应的完整URI，比如：

"redirect_uri": "com-yourcompany-appid-auth://login.microsoftonline.com/你的租户ID/oauth2/nativeclient"

确保authorization_user_agent设为BROWSER（保留系统浏览器SSO）
broker_redirect_uri_registered设为false（自定义scheme不需要broker注册）

4. 在Azure AD中配置重定向URI

进入Azure门户的应用注册页面，在「身份验证」选项卡：

添加移动和桌面应用类型的重定向URI，填入刚才的自定义URI（和MSAL配置里的一致）
添加Web类型的重定向URI，填入客户官网的地址（比如https://yourcompany.com/auth-callback）

5. 实现授权后跳转官网

MSAL的系统浏览器SSO流程必须先回到应用获取token，所以在MSAL的授权回调方法里（比如onActivityResult或者AuthenticationCallback的onSuccess方法），拿到token后手动启动系统浏览器跳转到客户官网：

// 示例：MSAL授权成功后的回调
@Override
public void onSuccess(IAuthenticationResult authenticationResult) {
    // 处理token逻辑（可选）
    // 跳转客户官网
    Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://yourcompany.com"));
    startActivity(browserIntent);
}

为什么之前的尝试无效？

修改broker_redirect_uri_registered：冲突根源是scheme被Chrome占用，和broker注册无关，所以没用
切换到WEBVIEW：应用内WebView不共享系统浏览器的登录状态，自然无法实现SSO
只改path不改scheme：还是用了被Chrome占用的msauth，冲突依旧；改redirect_uri后Azure不识别，是因为没在Azure后台同步配置

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