如何在keycloak-server.json中设置Keycloak默认主题？配置无效求助

可以在keycloak-server.json（新版本中对应standalone.xml/standalone-ha.xml）里设置默认主题，但你的配置格式有误，导致未生效。

问题分析 #

你配置的"default": "KEYCLOAK_DEFAULT_THEME:custom"格式错误：Keycloak主题配置中，无需添加KEYCLOAK_DEFAULT_THEME:前缀，且全局默认主题需通过复数形式的defaults字段，按主题类型分别指定。

正确配置示例 #

若你的自定义主题名为custom，正确配置如下：

"theme": {
    "staticMaxAge": "${keycloak.theme.staticMaxAge:-1}",
    "cacheTemplates": "${keycloak.theme.cacheTemplates:false}",
    "cacheThemes": "${keycloak.theme.cacheThemes:false}",
    "folder": {
        "dir": "src/main/resources/themes"
    },
    "defaults": {
        "login": "custom",
        "account": "custom",
        "admin": "custom",
        "email": "custom"
    }
}

• 字段为defaults（复数）而非default，可针对登录页、用户中心、管理控制台、邮件等不同场景单独设置主题；
• 确保custom主题目录结构符合Keycloak要求：themes/custom/[主题类型]/...，例如登录主题需放在themes/custom/login/下，包含必要的模板与资源文件。

生效操作 #

1. 保存修改后的配置文件
2. 重启Keycloak服务
3. 清除浏览器缓存（避免旧主题资源残留）

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