Docker化部署Spring Boot应用后locale多语言切换功能失效如何解决

以下三个方案均可保留原有openjdk基础镜像，按需选择即可： #

方案1：在现有Dockerfile中安装系统locale包 #

你使用的openjdk:11.0.11-oraclelinux7基础镜像基于Oracle Linux 7，默认裁剪了多语言locale包，直接在Dockerfile中添加安装逻辑即可，修改后配置如下：

FROM openjdk:11.0.11-oraclelinux7
# 安装需要的语言包，根据你支持的语言添加对应glibc-langpack-xxx包
RUN yum install -y glibc-langpack-en glibc-langpack-fr \
    && yum clean all
# 可根据需求调整默认locale
ENV LANG=zh_CN.UTF-8
ENV LC_ALL=zh_CN.UTF-8

ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-Dspring.profiles.active=prod","-jar","/app.jar"]

此方案改动最小，完全保留原有基础镜像和构建流程。 #

方案2：通过JVM启动参数绕过系统locale限制 #

不需要修改基础镜像，直接在JVM启动参数中强制指定locale配置，调整ENTRYPOINT如下：

ENTRYPOINT ["java","-Dspring.profiles.active=prod","-Djava.locale.providers=COMPAT,CLDR,SPI","-Duser.language=zh","-Duser.region=CN","-jar","/app.jar"]

其中-Djava.locale.providers=COMPAT,CLDR,SPI会优先读取JDK内置和应用自带的locale资源，不依赖系统locale配置。同时建议在Spring配置中显式关闭locale fallback到系统的逻辑，在application-prod.yml添加：

spring:
  messages:
    fallback-to-system-locale: false

避免找不到对应语言配置时读取系统默认locale触发异常。 #

方案3：显式配置Spring多语言规则 #

排查参数大小写敏感问题，你测试时使用的?Lang=en（首字母大写）和默认匹配的lang参数不匹配，建议显式注册LocaleChangeInterceptor统一参数名，示例配置：

@Configuration
public class I18nConfig implements WebMvcConfigurer {
    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver resolver = new SessionLocaleResolver();
        resolver.setDefaultLocale(Locale.SIMPLIFIED_CHINESE);
        return resolver;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        LocaleChangeInterceptor interceptor = new LocaleChangeInterceptor();
        // 显式指定参数名，需要大小写不敏感的话可以自定义逻辑覆盖拦截器preHandle方法
        interceptor.setParamName("lang");
        registry.addInterceptor(interceptor);
    }
}

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