Docker部署Keycloak12.0.2，业务应用跳转登录页的Realm主题不生效

• 排查SSO跳转URL的隐式参数干扰
  打开浏览器开发者工具的网络面板，从业务应用触发登录跳转，抓取下一跳完整的授权请求URL。重点检查URL查询参数里是否硬编码了kc_theme=keycloak参数：Keycloak的主题加载优先级里，URL携带的kc_theme参数权重最高，会完全覆盖Realm、Client级别的主题配置。很多旧版SSO对接模板会把这个参数硬编码在跳转链接里，只要删掉这个参数，就会自动走Realm配置的主题逻辑。
• 核对业务Client的单独主题配置
  进入Keycloak管理台，选中对应业务所属的Realm，进入Clients菜单找到对接的业务客户端，在客户端设置页下拉到Login theme配置项。Client级别的主题配置优先级高于Realm全局配置，只要这里被手动设置成了keycloak官方默认主题，不管Realm层配什么自定义主题，SSO跳转的登录页都会强制加载这个默认主题。把这个配置改回“跟随Realm设置”即可。
• 校验授权端点的Realm路径正确性
  标准OIDC授权端点的格式为Keycloak服务地址/auth/realms/{目标Realm名称}/protocol/openid-connect/auth，如果业务应用对接时硬编码了错误的Realm名称（比如写死成公共测试Realm、不存在的Realm名），Keycloak会直接 fallback 到全局默认主题，完全不读取你配置的对应Realm自定义主题。把跳转URL里的Realm路径段替换为业务所属的正确Realm名称即可。
• 排除本地缓存导致的假异常
  打开无痕浏览窗口，不读取本地任何缓存和Cookie，从业务应用触发登录跳转测试。如果无痕窗口下自定义主题正常加载，说明之前的异常是浏览器缓存了旧版默认登录页导致的，清理本地Keycloak域名下的所有缓存、Cookie后即可恢复正常。

注意：你已经完成的主题缓存关闭、容器重启操作是正确的，这些配置修改不需要重复操作。因为已经关闭了主题/模板缓存，所有Realm、Client级别的主题配置修改都是实时生效的，不需要每次修改后重启Keycloak。

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