Blazor Server如何为每个客户端连接查询数据库设置默认语言文化

问题根因 #

• Startup.Configure 中配置的 DefaultRequestCulture 是全局静态属性，仅在服务启动时赋值一次，后续不会自动更新，所以无法响应用户偏好的修改。
• MainLayout.razor 中修改文化的时机在首次渲染完成之后，所以需要手动刷新页面才能看到效果。

最优解决方案：自定义请求文化提供器 #

ASP.NET Core 的请求本地化管道支持自定义 RequestCultureProvider，可以在每次请求（包括Blazor初始连接请求）时动态获取文化配置，优先级可以自定义，不需要修改业务层代码，首次渲染即可生效。

步骤1：实现自定义文化提供器 #

using Microsoft.AspNetCore.Localization;
using System.Security.Claims;

public class UserPreferenceRequestCultureProvider : RequestCultureProvider
{
    public override async Task<ProviderCultureResult?> DetermineProviderCultureResult(HttpContext httpContext)
    {
        // 未登录用户直接返回null，走后续默认 fallback 规则
        if (!httpContext.User.Identity?.IsAuthenticated ?? true)
        {
            return null;
        }

        // 从DI容器获取用户服务、数据库上下文等依赖，不要手动实例化
        var userService = httpContext.RequestServices.GetRequiredService<IUserService>();
        var userId = httpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
        var userPreferences = await userService.GetPreferences(userId);

        // 偏好为空或者语言不被支持的情况走默认规则
        if (string.IsNullOrWhiteSpace(userPreferences?.language) 
            || !SupportedCultures.Any(c => c.Name.Equals(userPreferences.language, StringComparison.OrdinalIgnoreCase)))
        {
            return null;
        }

        return new ProviderCultureResult(userPreferences.language);
    }
}

注：SupportedCultures 替换为你项目中定义的支持文化列表即可

步骤2：注册自定义提供器到本地化配置 #

修改 Startup.ConfigureServices 中的请求本地化配置，调整提供器的优先级：

services.Configure<RequestLocalizationOptions>(options =>
{
    options.SupportedCultures = SupportedCultures;
    options.SupportedUICultures = SupportedCultures;
    
    // 原有提供器保持优先级，自定义提供器作为QueryString、Cookie之后的兜底规则
    options.RequestCultureProviders.Add(new UserPreferenceRequestCultureProvider());
    
    // 如果需要让用户偏好优先级最高，覆盖QueryString和Cookie的配置，改用如下写法
    // options.RequestCultureProviders.Insert(0, new UserPreferenceRequestCultureProvider());
});

步骤3：确保中间件顺序正确 #

在 Startup.Configure 中，UseRequestLocalization 必须放在路由、Blazor相关中间件之前：

// 放在最前面优先执行
app.UseRequestLocalization();

app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    endpoints.MapBlazorHub();
    endpoints.MapFallbackToPage("/_Host");
});

优化建议 #

• 可以对用户偏好查询结果加5-10分钟的短缓存，减少数据库查询压力，用户修改偏好时主动删除对应缓存即可即时生效。
• .NET 6及以上版本Blazor Server默认会让SignalR连接继承初始HTTP请求的文化，无需额外配置；.NET 5及以下版本需要手动配置Blazor Hub的文化继承规则。

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