Blazor项目本地化异常：切换语言仅对当前Razor页面生效

你遇到的核心问题是：Server Blazor中直接修改Thread.CurrentThread.CurrentCulture/CurrentUICulture仅对当前组件的单次渲染周期有效。原因在于：

• Server Blazor基于SignalR维护用户连接，组件的渲染上下文是短暂且隔离的，线程文化的修改不会被持久化到用户的全局会话中。
• 当导航到其他页面或组件重新渲染时，新的上下文会重新读取默认文化配置（比如系统语言），不会继承之前的线程修改。

另外，你未将用户选择的语言偏好与用户身份绑定并持久化到数据库，导致后续请求无法感知用户的语言选择。

1. 实现用户语言偏好存储服务 #

首先创建操作数据库的服务，用于读取和保存用户的语言设置：

public interface IUserCultureService
{
    Task<string> GetUserPreferredCultureAsync(string userId);
    Task SaveUserPreferredCultureAsync(string userId, string cultureName);
}

public class UserCultureService : IUserCultureService
{
    private readonly AppDbContext _dbContext;

    public UserCultureService(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    public async Task<string> GetUserPreferredCultureAsync(string userId)
    {
        var profile = await _dbContext.UserProfiles
            .FirstOrDefaultAsync(p => p.UserId == userId);
        return profile?.PreferredCulture ?? CultureInfo.CurrentCulture.Name;
    }

    public async Task SaveUserPreferredCultureAsync(string userId, string cultureName)
    {
        var profile = await _dbContext.UserProfiles
            .FirstOrDefaultAsync(p => p.UserId == userId);
        if (profile != null)
        {
            profile.PreferredCulture = cultureName;
            await _dbContext.SaveChangesAsync();
        }
    }
}

在服务注册中添加：

services.AddScoped<IUserCultureService, UserCultureService>();
services.AddHttpContextAccessor(); // 需要访问HttpContext获取用户ID

2. 自定义请求文化提供器 #

实现IRequestCultureProvider，让Blazor在每次请求启动时自动从数据库读取用户的语言偏好：

public class UserProfileCultureProvider : IRequestCultureProvider
{
    private readonly IUserCultureService _cultureService;
    private readonly IHttpContextAccessor _httpContextAccessor;

    public UserProfileCultureProvider(IUserCultureService cultureService, IHttpContextAccessor httpContextAccessor)
    {
        _cultureService = cultureService;
        _httpContextAccessor = httpContextAccessor;
    }

    public async Task<ProviderCultureResult> DetermineProviderCultureResult(HttpContext httpContext)
    {
        var userId = httpContext.User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
        if (!string.IsNullOrEmpty(userId))
        {
            var preferredCulture = await _cultureService.GetUserPreferredCultureAsync(userId);
            if (!string.IsNullOrEmpty(preferredCulture))
            {
                return new ProviderCultureResult(preferredCulture, preferredCulture);
            }
        }
        // 无用户偏好时返回默认值
        return null;
    }
}

更新本地化服务注册，将自定义提供器设为最高优先级：

services.AddLocalization(options => options.ResourcesPath = "Resources");

services.Configure<RequestLocalizationOptions>(options =>
{
    var supportedCultures = new[]
    {
        new CultureInfo("zh-CN"),
        new CultureInfo("en-US")
        // 添加其他支持的语言
    };

    options.DefaultRequestCulture = new RequestCulture("zh-CN");
    options.SupportedCultures = supportedCultures;
    options.SupportedUICultures = supportedCultures;

    // 插入自定义提供器到最前面
    options.RequestCultureProviders.Insert(0, new UserProfileCultureProvider(
        services.BuildServiceProvider().GetRequiredService<IUserCultureService>(),
        services.BuildServiceProvider().GetRequiredService<IHttpContextAccessor>()
    ));
});

3. 修改页面语言切换逻辑 #

不再直接修改线程文化，改为保存偏好到数据库并强制刷新页面，让新的请求加载用户的语言设置：

@inject IUserCultureService UserCultureService
@inject NavigationManager NavigationManager
@inject AuthenticationStateProvider AuthStateProvider

<select @onchange="HandleCultureChange">
    <option value="zh-CN">中文</option>
    <option value="en-US">English</option>
</select>

@code {
    private async Task HandleCultureChange(ChangeEventArgs e)
    {
        var culture = e.Value.ToString();
        var authState = await AuthStateProvider.GetAuthenticationStateAsync();
        var userId = authState.User.FindFirst(ClaimTypes.NameIdentifier)?.Value;
        
        if (!string.IsNullOrEmpty(userId))
        {
            await UserCultureService.SaveUserPreferredCultureAsync(userId, culture);
            // 强制刷新页面，让新的文化设置全局生效
            NavigationManager.NavigateTo(NavigationManager.Uri, forceLoad: true);
        }
    }
}

4. 验证全局生效 #

完成以上配置后，用户切换语言并刷新页面后，所有组件的IStringLocalizer<>都会自动加载用户数据库中保存的语言对应的资源文件，实现全局语言切换效果。

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