如何通过语言选择器实现Spring Boot应用全局语言切换

核心问题分析 #

你的配置存在两个关键错误，导致CookieLocaleResolver无法将选中的语言持久化到Cookie中，进而无法全局生效：

1. CookieLocaleResolver配置错误：你调用了setCookieDomain("myAppLocaleCookie")，但该方法用于设置Cookie的域名（如example.com），而非Cookie的名称。正确的方法是setCookieName，否则Cookie无法被正确创建和读取。
2. 拦截器路径覆盖不全：addPathPatterns("/*")仅匹配一级路径（如/international），多级路径（如/user/detail）的请求不会被拦截，导致语言切换失效。

修复步骤 #

1. 修正LocaleResolver配置 #

修改WebMvcConfig中的getLocaleResolver方法，将setCookieDomain替换为setCookieName：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Bean(name = "localeResolver")
    public LocaleResolver getLocaleResolver()  {
        CookieLocaleResolver resolver= new CookieLocaleResolver();
        resolver.setCookieName("myAppLocaleCookie"); // 修正为设置Cookie名称
        resolver.setCookieMaxAge(60*60); // Cookie有效期60分钟
        resolver.setDefaultLocale(Locale.ENGLISH); // 可选：设置默认语言
        return resolver;
    }

    // 其他Bean配置保持不变
    @Bean(name = "messageSource")
    public MessageSource getMessageResource()  {
        ReloadableResourceBundleMessageSource messageResource= new ReloadableResourceBundleMessageSource();
        messageResource.setBasename("classpath:i18n/messages");
        messageResource.setDefaultEncoding("UTF-8");
        return messageResource;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        LocaleChangeInterceptor localeInterceptor = new LocaleChangeInterceptor();
        localeInterceptor.setParamName("lang");
        registry.addInterceptor(localeInterceptor).addPathPatterns("/**"); // 修改为匹配所有路径
    }
}

2. 优化前端语言选择逻辑 #

当前JS固定跳转到/international页面，用户在其他页面切换语言会跳回首页，体验不佳。改为跳转到当前页面并保留现有查询参数：

<select id="locales">
    <option value="" th:text="#{choose.language}"></option>
    <option value="en" th:text="#{english}" th:selected="${#locale.language == 'en'}"></option>
    <option value="hy" th:text="#{armenian}" th:selected="${#locale.language == 'hy'}"></option>
</select>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.1.1/jquery.min.js"></script>
<script type="text/javascript">
    $(document).ready(function() {
        $("#locales").change(function () {
            var selectedOption = $(this).val();
            if (selectedOption) {
                // 获取并更新当前页面的查询参数
                var urlParams = new URLSearchParams(window.location.search);
                urlParams.set('lang', selectedOption);
                // 跳转到当前页面并应用新的语言参数
                window.location.replace(window.location.pathname + '?' + urlParams.toString());
            }
        });
    });
</script>

同时注意：

• 选项文本使用国际化消息（如#{english}），确保选项本身随语言切换
• 添加th:selected属性，让当前选中的语言在下拉框中高亮显示

3. 确认国际化资源文件配置 #

确保src/main/resources/i18n/目录下的资源文件包含对应键值：

• messages_en.properties：

  choose.language=Choose Language
  english=English
  armenian=Armenian
  

• messages_hy.properties：

  choose.language=Ընտրել լեզու
  english=Անգլերեն
  armenian=Հայերեն
  

验证效果 #

修复后，切换语言时：

1. 浏览器会创建名为myAppLocaleCookie的Cookie，持久化选中的语言设置
2. 所有页面请求都会读取该Cookie，实现语言全局生效
3. 在任意页面切换语言，都会保持当前页面并更新显示语言

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