.NET MAUI中Keycloak集成Google/Apple登录重定向URI无效问题

以下是排查和解决问题的核心步骤：

1. 验证Keycloak重定向URI配置 #

• 确认Keycloak客户端的Valid Redirect URIs包含精确匹配的 nellspay://auth/callback，或使用通配符覆盖（如 nellspay://auth/callback*）。注意URI的大小写、斜杠要完全一致，避免多余字符。
• 确保客户端类型设置为Public（移动客户端属于无Secret的Public类型，这是Keycloak允许重定向的前提）。

2. 配置平台端的URI Scheme支持 #

Android 配置（AndroidManifest.xml） #

在<activity>节点内添加处理重定向的intent-filter：

<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="nellspay" android:host="auth" android:path="/callback" />
</intent-filter>

iOS 配置（Info.plist） #

添加URL Scheme查询权限和回调配置：

<!-- 允许应用查询自定义Scheme -->
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>nellspay</string>
</array>

<!-- 注册应用的回调Scheme -->
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>nellspay</string>
        </array>
        <key>CFBundleURLName</key>
        <string>AuthCallback</string>
    </dict>
</array>

3. 修正代码中的URI构建逻辑 #

避免手动拼接URL导致的编码错误，改用UriBuilder和自动编码构建登录URL：

string clientId = "nellspay-mobile";
string redirectUri = "nellspay://auth/callback";

var loginUriBuilder = new UriBuilder("https://identity.nellspay.com/realms/nellspay/protocol/openid-connect/auth");
var queryParams = new Dictionary<string, string>
{
    {"client_id", clientId},
    {"redirect_uri", redirectUri},
    {"response_type", "code"},
    {"scope", "openid email profile"},
    {"kc_idp_hint", "google"}
};

// 自动编码参数，避免手动拼接的编码错误
loginUriBuilder.Query = string.Join("&", queryParams.Select(kv => 
    $"{Uri.EscapeDataString(kv.Key)}={Uri.EscapeDataString(kv.Value)}"));

try
{
    var result = await WebAuthenticator.AuthenticateAsync(
        loginUriBuilder.Uri,
        new Uri(redirectUri));

    if (result?.Properties.TryGetValue("code", out var code) == true)
    {
        await ExchangeCodeForTokenAsync(code, clientId, redirectUri);
        _toastService.ShowToast("Login successful.");
        return (true, null, null, null); // 根据实际业务调整返回值
    }

    _toastService.ShowToast("Login was cancelled.");
    return (false, null, null, null);
} 
catch (Exception ex)
{
    _toastService.ShowToast($"Login failed: {ex.Message}");
    return (false, null, null, null);
}

4. 额外检查点 #

• 测试时确保设备/模拟器的网络能正常访问Keycloak服务器。
• 清除Keycloak客户端缓存，或重启Keycloak服务（若配置修改后未生效）。

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