Keycloak 18自定义登录主题添加乌语翻译后，后台找不到uk locale怎么办

核心问题 #

Keycloak默认不会自动识别并启用新的语言环境——即便你创建了messages_uk.properties翻译文件，也需要先配置让Keycloak将uk（乌克兰语）标记为可用语言，否则管理控制台和登录页面都不会显示该语言选项。

正确配置步骤 #

1. 确认翻译文件的正确性 #

你创建的/keycloak/themes/custom/login/messages/messages_uk.properties路径与命名是合规的，只需确保文件内的键值对与默认messages.properties匹配，示例内容如下：

username=Логін
password=Пароль
signIn=Увійти
forgotPassword=Забули пароль?

2. 让Keycloak启用乌克兰语环境 #

有两种配置方式可选：

方式一：仅针对当前主题启用

编辑/keycloak/themes/custom/login/theme.properties，添加或修改语言支持列表，将uk加入其中：

locales=uk,en,zh-CN

逗号分隔的顺序即为语言选项在页面上的显示顺序。

方式二：全局启用（全实例所有主题生效）

编辑/keycloak/conf/keycloak.conf，添加全局语言配置：

spi-theme-default-locale=en
spi-theme-supported-locales=uk,en,zh-CN

配置完成后重启Keycloak服务。

3. 验证配置效果 #

• 进入管理控制台，打开对应Realm的Realm设置 → 本地化页面，即可看到uk语言选项
• 登录页面的语言切换下拉菜单会显示乌克兰语，选择后将加载你定义的翻译内容

额外注意事项 #

• 若只需特定Realm支持乌克兰语，可在该Realm的本地化设置中，手动将uk添加到支持语言列表
• 确保messages_uk.properties文件编码为UTF-8，避免出现乱码

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