求Keycloak模板可用变量完整文档及官方参考链接

我完全理解你找这些变量时的零散感——Keycloak的模板变量确实分散在不同文档章节里，不过官方其实有系统整理的内容，我帮你梳理一下：

常见的模板可用变量 #

• 用户相关：除了你找到的${user.attributes}，还有${user.username}、${user.email}、${user.firstName}、${user.lastName}、${user.id}，甚至可以直接访问用户属性的具体字段比如${user.attributes.phoneNumber}
• URL与路径相关：${url.resourcesPath}之外，还有${url.loginAction}、${url.logoutAction}、${url.registerAction}、${url.resetCredentialsAction}，以及${url.basePath}（Keycloak实例的基础路径）
• 客户端与Realm相关：${realm.name}、${client.clientId}、${client.name}
• 模板上下文与通用变量：${locale}（当前语言环境）、${theme.name}（当前使用的主题名称）、${messages.error}（错误提示信息，用于登录/注册等场景）、${csrf.token}（CSRF令牌，表单提交时常用）
• 邮件模板专属变量：如果是邮件类模板，还有${url.login}（登录链接）、${user.verifyEmailLink}（邮箱验证链接）、${user.resetPasswordLink}（重置密码链接）、${expirationDate}（链接过期时间）

官方文档的系统查看方式 #

Keycloak的官方文档里，在主题与模板相关章节中，专门有对模板可用变量的详细说明。你可以在官方文档的「Server Administration Guide」下的「Themes」部分找到，里面分不同模板类型（登录页面、邮件、账户管理页面等）列出了对应的可用变量，还会说明变量的类型和使用场景。

另外，如果你想快速验证某个变量是否可用，也可以在模板中临时添加${variableName}，然后触发对应的页面/邮件，看是否能正确渲染出值——不过还是优先参考官方文档的正式说明更稳妥。

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