Keycloak移动端配置重定向URI时多余斜杠问题求助

问题背景 #

配置移动端OIDC认证时，Keycloak客户端设置的重定向URI为myapp://tabs/home，但实际返回给移动端的是myapp:///tabs/home（多了一个斜杠），导致自定义URL Scheme处理报错。

问题根源 #

Keycloak会按照URI规范对重定向地址做规范化处理：对于没有权威机构（authority）部分的自定义scheme，Keycloak会自动在scheme://后补一个斜杠，变成scheme:///，这是其默认的URI格式化逻辑。

已验证可行的解决方案 #

1. 调整Keycloak客户端重定向URI配置 #

直接在Keycloak客户端的重定向URI中配置带三个斜杠的地址：myapp:///tabs/home，同时在移动端的URL Scheme配置中也匹配该格式。这种方式无需修改代码，直接适配Keycloak的规范化行为。

2. 移动端侧拦截并修正URI #

在移动端的URL Scheme处理逻辑中，添加字符串替换，将多余的斜杠去除后再处理：

Android示例（Kotlin）

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    intent?.data?.let { uri ->
        val originalUriStr = uri.toString()
        val fixedUriStr = if (originalUriStr.startsWith("myapp:///")) {
            originalUriStr.replaceFirst("myapp:///", "myapp://")
        } else {
            originalUriStr
        }
        val fixedUri = Uri.parse(fixedUriStr)
        // 后续处理fixedUri
    }
}

iOS示例（Swift）

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    var targetUrl = url
    if url.absoluteString.hasPrefix("myapp:///") {
        guard let fixedStr = URL(string: url.absoluteString.replacingOccurrences(of: "myapp:///", with: "myapp://")) else {
            return false
        }
        targetUrl = fixedStr
    }
    // 处理targetUrl
    return true
}

3. 自定义Keycloak SPI修改URI逻辑（进阶） #

如果需要从服务端彻底解决，可编写自定义SPI覆盖Keycloak的URI规范化逻辑：

• 实现UriBuilder的扩展类，针对自定义scheme跳过额外斜杠的添加
• 将打包后的JAR放入Keycloak的providers目录
• 在Keycloak管理控制台启用该SPI

针对疑问的解答 #

1. 该问题非常常见，大量使用自定义URL Scheme的移动端开发者都遇到过，属于Keycloak默认的URI格式化行为。
2. Keycloak没有直接的开关禁用该行为，但可以通过上述配置调整或自定义SPI修复。
3. 移动端需在URL Scheme处理代码中添加斜杠修正逻辑，或者同时配置支持myapp://和myapp:///两种格式的URI匹配规则。

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