Java11+Spring5.3.9中LocaleContextHolder返回仅语言码问题如何解决

• ThreadLocal上下文隔离：LocaleContextHolder默认基于ThreadLocal存储Locale上下文，仅当前线程可访问。Java并行流底层使用ForkJoinPool线程池执行任务，池内工作线程不属于发起请求的web工作线程（如示例中的nio-8080线程），默认无法继承到主线程绑定的完整en_US上下文。
• Fallback逻辑触发：当子线程未绑定任何LocaleContext时，LocaleContextHolder.getLocale()会自动回退调用Locale.getDefault()获取JVM全局默认Locale。多数操作系统/容器的JVM默认Locale仅配置了语言码（如en），未指定国家码，就会出现仅返回语言码的问题。
• 线程复用干扰：ForkJoinPool的线程是全局复用的，如果之前有其他逻辑给复用的线程设置过仅含语言码的Locale，也会导致后续任务拿到不完整的Locale。

方案1：显式传递Locale（首选，无副作用） #

不要在并行流内部调用LocaleContextHolder，直接在主线程提前获取完整Locale后传入并行流任务，示例代码：

// 主线程提前获取当前请求的完整Locale
Locale currentLocale = LocaleContextHolder.getLocale();
contacts.parallelStream().forEach(contact -> {
    // 直接使用传入的currentLocale，无需再从上下文读取
    // 业务逻辑
});

该方案无需额外全局配置，不会出现上下文串用问题，优先推荐使用。

方案2：开启上下文继承配置 #

如果项目内多处需要在子线程读取Locale上下文，可开启Spring的上下文继承能力：

1. 配置LocaleContextHolder默认使用可继承的ThreadLocal：

@PostConstruct
public void initLocaleConfig() {
    LocaleContextHolder.setDefaultInheritable(true);
}

2. 配套修改RequestContextFilter配置，允许请求上下文向子线程传播：

@Bean
public RequestContextFilter requestContextFilter() {
    RequestContextFilter filter = new RequestContextFilter();
    filter.setThreadContextInheritable(true);
    return filter;
}

注意：该方案可能导致复用的ForkJoinPool线程出现不同请求的上下文串用问题，需要结合业务场景评估风险后使用。

方案3：强制设置JVM默认Locale为完整格式 #

如果服务的基础Locale固定，可在服务启动时强制设置JVM全局默认Locale为带国家码的完整格式，即使触发fallback也不会返回仅含语言码的结果：

// 启动类main方法最前端添加，按需修改为你需要的默认Locale
Locale.setDefault(new Locale("en", "US"));

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