ASP.NET Core端点文化切换器设置的线程UI区域性不生效问题

问题表现 #

• 基于.NET Core 3.1开发的ASP.NET应用，部署上线约20分钟后，特定接口返回的多语言资源字符串固定加载实例配置的主区域性语言，无法按请求参数切换
• 项目采用.resx文件存储三类语言资源（通用中性、瑞典语sv、英语en），资源文件统一放在独立类库中，支持Lang.General.EmailSubject这类强类型方式调用。这套资源调用逻辑在项目其余业务点运行正常，仅当前带自定义文化切换逻辑的接口出现异常，该接口也是唯一使用这套自定义切换逻辑的位置
• 线上共两个部署实例：主区域性分别配置为sv-SE、en-GB。接口调用方可通过请求参数requestedCulture传入sv-GB或en-SE指定返回语言。99%场景下传入的文化参数和实例主区域性一致，运行正常；少数传入不同文化值的场景会出现翻译错误。问题每次部署后均可稳定复现，暂未定位根因

复现代码 #

public sealed class TemporaryLanguageSwitcher : IDisposable
{
    private readonly CultureInfo initialCulture;
    private readonly CultureInfo initialUiCulture;

    public TemporaryLanguageSwitcher(CultureInfo culture)
    {
        initialCulture = CultureInfo.CurrentCulture;
        initialUiCulture = CultureInfo.CurrentUICulture;

        CultureInfo.CurrentCulture = culture;
        CultureInfo.CurrentUICulture = culture;
    }

    void IDisposable.Dispose()
    {
        CultureInfo.CurrentCulture = initialCulture;
        CultureInfo.CurrentUICulture = initialUiCulture;
    }
}

public static class CultureInfoExtensions
{
    public static TemporaryLanguageSwitcher AsThreadCulture(this CultureInfo culture)
    {
        return new TemporaryLanguageSwitcher(culture);
    }
}

public class MailController : ControllerBase
{
    public static IDisposable CultureSetter(CultureInfo newCulture) => newCulture.AsThreadCulture();

    public static IDisposable CreateEmailRequestScope(EmailRequest request)
    {
        string culture = string.IsNullOrEmpty(request.requestedCulture) ? "sv-SE" : request.requestedCulture; //en-SE
        return CultureSetter(CultureInfo.GetCultureInfo(culture));
    }

    [HttpPost]
    public async Task<MailResponse> SendEmail([FromBody] EmailRequest request)
    {
        var requestCulture = request.requestedCulture; //en-SE
        var emailSubject = Lang.General.EmailSubject; //始终返回默认语言
        using (CreateEmailRequestScope(request))
        {
            var emailSubject = Lang.General.EmailSubject; //部署10-20分钟后返回错误值：预期返回Hello，实际返回Hej
            request.emailSubject = emailSubject; 
            return await mailer.Send(request);
        }
    }
}

根因定位 #

这个问题是.NET Core异步场景下手动切换线程文化的典型边界问题，核心诱因有三个：

1. 线程池线程污染：自定义TemporaryLanguageSwitcher虽然看似做了文化还原，但在async/await场景下，await操作会出让当前线程，后续逻辑（包括Dispose还原文化的操作）会从线程池调度任意空闲线程执行。被修改过文化的原线程会被直接放回线程池，其Culture属性不会被还原，运行时间越长，被污染的线程池线程越多，20分钟左右所有常用线程池线程都会被污染为进程默认主文化，后续手动切换文化的逻辑会被线程池默认值覆盖。
2. 资源回退逻辑失效：接口传入的en-SE、sv-GB属于区域性子文化，而项目只提供了en、sv两个中性文化的资源文件，没有显式配置子文化到中性文化的回退映射。当线程文化被污染后，ResourceManager的内部缓存会直接命中主文化的资源集，不再按层级查找父级中性文化的卫星程序集资源。
3. 资源缓存边界问题：强类型资源生成的调用逻辑默认依赖当前线程的CurrentUICulture读取资源，没有显式传入目标文化参数，当线程上下文文化因为线程复用出现混乱时，资源读取会直接走缓存的默认文化值。

修复方案 #

按优先级执行以下修复即可彻底解决问题：

• 优先替换为官方请求本地化中间件：移除自定义的文化切换逻辑，使用ASP.NET Core自带的RequestLocalizationMiddleware处理文化切换，该组件基于AsyncLocal存储请求上下文文化，天然适配async/await场景，不会污染线程池线程。配置示例：

  // Program.cs或Startup.ConfigureServices中注册
  services.Configure<RequestLocalizationOptions>(options =>
  {
      var supportedCultures = new[]
      {
          CultureInfo.GetCultureInfo("sv-SE"),
          CultureInfo.GetCultureInfo("en-GB"),
          CultureInfo.GetCultureInfo("sv-GB"),
          CultureInfo.GetCultureInfo("en-SE")
      };
      options.DefaultRequestCulture = new RequestCulture("sv-SE");
      options.SupportedCultures = supportedCultures;
      options.SupportedUICultures = supportedCultures;
      // 自定义文化读取逻辑，从请求参数取requestedCulture
      options.RequestCultureProviders.Clear();
      options.RequestCultureProviders.Add(new CustomRequestCultureProvider(context =>
      {
          var culture = context.Request.Query["requestedCulture"].FirstOrDefault() ?? "sv-SE";
          return Task.FromResult(new ProviderCultureResult(culture));
      }));
  });
  
  // Startup.Configure中，放在所有业务中间件之前启用
  app.UseRequestLocalization();
  

• 若需保留手动切换逻辑，修复上下文问题：在切换逻辑中增加disposed标记，避免重复还原，同时不要在using块内直接return await，先接收返回值，等文化还原完成后再返回，减少跨线程污染概率。
• 显式配置资源与文化映射：在资源类库中添加中性资源语言标记，同时启动时显式配置子文化的父级映射，确保回退逻辑正常：

  // 资源类库AssemblyInfo.cs中添加
  [assembly: System.Resources.NeutralResourcesLanguage("en")]
  
  // 应用启动时添加文化映射
  CultureInfo.GetCultureInfo("en-SE").Parent = CultureInfo.GetCultureInfo("en");
  CultureInfo.GetCultureInfo("sv-GB").Parent = CultureInfo.GetCultureInfo("sv");
  

• 临时排查手段：在using块内添加日志，打印当前CultureInfo.CurrentUICulture.Name和指定文化下的资源值，快速确认是文化设置失效还是资源加载异常。

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