ASP.Net Core 3.1中CookieRequestCultureProvider不生效问题排查

你碰到的这个问题我之前也踩过坑，ASP.NET Core 3.1里Cookie文化不生效，通常是中间件顺序错误、未配置支持的文化列表或者Cookie设置不完整这几个原因导致的，咱们一步步排查：

1. 检查中间件的注册顺序（最常见的坑） #

UseRequestLocalization必须在其他依赖文化的中间件之前注册，比如UseRouting、UseEndpoints、UseMvc这些。如果顺序错了，请求已经进入路由/控制器处理流程了，文化设置才生效，自然不会起作用。

正确的Configure方法顺序应该是这样：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    ...
    // 先注册本地化中间件
    var options = app.ApplicationServices.GetService<IOptions<RequestLocalizationOptions>>();
    app.UseRequestLocalization(options.Value);

    // 再注册路由、认证、授权、端点等中间件
    app.UseRouting();
    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

2. 配置支持的文化列表 #

如果你的RequestLocalizationOptions没有指定SupportedCultures和SupportedUICultures，当Cookie里的文化不在默认支持列表里时，ASP.NET Core会自动 fallback 到默认文化（也就是你看到的en-ZA）。

修改ConfigureServices里的配置，加上支持的文化：

public void ConfigureServices(IServiceCollection services)
{
    ...
    services.Configure<RequestLocalizationOptions>(options =>
    {
        // 定义你的应用支持的所有文化
        var supportedCultures = new[]
        {
            new CultureInfo("en-ZA"),
            new CultureInfo("en-US"),
            // 加上用户可能用到的其他文化，比如"zh-CN"等
        };

        // 设置默认文化
        options.DefaultRequestCulture = new RequestCulture("en-ZA");
        // 指定支持的文化和UI文化
        options.SupportedCultures = supportedCultures;
        options.SupportedUICultures = supportedCultures;

        // 只保留Cookie作为文化提供者
        options.RequestCultureProviders = new[] { new CookieRequestCultureProvider() };
    });
}

3. 完善Cookie的设置参数 #

设置Cookie时，最好显式指定路径、有效期等参数，避免浏览器因为Cookie属性问题不发送或者服务器无法识别：

HttpContext.Response.Cookies.Append(
    CookieRequestCultureProvider.DefaultCookieName,
    CookieRequestCultureProvider.MakeCookieValue(new RequestCulture([logged-in-user].CultureCode)),
    new CookieOptions
    {
        Expires = DateTimeOffset.UtcNow.AddYears(1), // 设置有效期，避免会话结束就失效
        Path = "/", // 确保Cookie对整个站点生效
        IsEssential = true, // 标记为必要Cookie，在隐私模式下也能被发送
        HttpOnly = false // 不需要HttpOnly，因为客户端可能需要读取这个Cookie
    });

4. 正确验证当前文化 #

不要用System.Threading.Thread.CurrentThread.CurrentCulture来验证，ASP.NET Core里推荐用HttpContext.RequestCulture或者CultureInfo.CurrentCulture（因为ASP.NET Core会在请求开始时设置当前线程的文化，但异步场景下可能有偏差）。在Action里这样验证：

public IActionResult SomeAction()
{
    // 推荐的方式
    var requestCulture = HttpContext.RequestCulture.Culture.Name;
    // 或者
    var currentCulture = CultureInfo.CurrentCulture.Name;
    
    // 断点查看这两个值，确认是否和Cookie里的一致
    return Ok();
}

额外检查点 #

• 确认用户的CultureCode格式正确，比如是en-US而不是enUS或者ENUS，必须符合标准的文化代码格式。
• 清除浏览器缓存和旧的文化Cookie，避免之前的无效Cookie干扰测试。

内容的提问来源于stack exchange，提问作者Shawn de Wet