Blazor Server（.NET6）用户独立切换语言全局生效问题求助

核心问题根源 #

Blazor Server基于长连接+线程池复用机制，直接修改CultureInfo.DefaultThreadCurrentCulture会全局污染所有用户的线程文化；仅设置CultureInfo.CurrentCulture只能作用于当前线程，且组件无法感知文化变更自动刷新，导致只有修改时的组件更新，其他组件无变化。

分步解决方案 #

1. 完善本地化服务配置（Program.cs）

除了AddLocalization，还需配置资源路径、会话支持，并添加请求本地化中间件，确保用户文化能持久化并在请求间生效：

// 配置本地化资源路径（资源文件放在项目根目录的Resources文件夹下）
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");

// 添加会话支持，用于临时存储用户文化
builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromHours(24);
    options.Cookie.HttpOnly = true;
    options.Cookie.IsEssential = true;
});

// 配置请求本地化支持的文化列表
builder.Services.Configure<RequestLocalizationOptions>(options =>
{
    var supportedCultures = new[]
    {
        new CultureInfo("en"),
        new CultureInfo("zh-CN"),
        // 按需添加其他支持的文化
    };

    options.DefaultRequestCulture = new RequestCulture("en");
    options.SupportedCultures = supportedCultures;
    options.SupportedUICultures = supportedCultures;
    // 使用Cookie持久化用户文化选择
    options.RequestCultureProviders.Insert(0, new CookieRequestCultureProvider());
});

// 中间件顺序注意：UseSession要在UseRouting之后，UseAuthorization之前
app.UseSession();
app.UseRequestLocalization(app.Services.GetRequiredService<IOptions<RequestLocalizationOptions>>().Value);

2. 创建Scoped级别的文化状态管理服务

由于Blazor组件是Scoped生命周期，创建一个Scoped服务来管理用户专属的文化状态，并提供变更通知：

public class UserCultureState
{
    // 文化变更时触发的事件，用于通知组件刷新
    public event Action OnCultureChanged;

    private CultureInfo _currentCulture;
    private CultureInfo _currentUICulture;

    public CultureInfo CurrentCulture
    {
        get => _currentCulture;
        set
        {
            _currentCulture = value;
            _currentUICulture = value;
            NotifyCultureChanged();
        }
    }

    public CultureInfo CurrentUICulture
    {
        get => _currentUICulture;
        set
        {
            _currentUICulture = value;
            NotifyCultureChanged();
        }
    }

    private void NotifyCultureChanged() => OnCultureChanged?.Invoke();
}

在Program.cs中注册为Scoped服务：

builder.Services.AddScoped<UserCultureState>();

3. 组件中监听文化变更并自动刷新

在需要本地化的组件（比如MainLayout、各业务组件）中，注入UserCultureState并订阅变更事件，触发组件刷新：

@inject UserCultureState CultureState
@inject IStringLocalizer<SharedResources> Localizer
@inject IUserRepository UserRepository
@inject IHttpContextAccessor HttpContextAccessor

<!-- 语言选择下拉菜单示例 -->
<select @onchange="ChangeLanguage">
    <option value="en">English</option>
    <option value="zh-CN">中文</option>
</select>

<p>@Localizer["WelcomeMessage"]</p>

@code {
    protected override void OnInitialized()
    {
        // 订阅文化变更事件，收到通知后刷新组件
        CultureState.OnCultureChanged += () => StateHasChanged();
    }

    private async Task ChangeLanguage(ChangeEventArgs e)
    {
        var cultureCode = e.Value.ToString();
        var newCulture = new CultureInfo(cultureCode);

        // 更新Scoped文化状态
        CultureState.CurrentCulture = newCulture;

        // 1. 保存用户偏好到数据库（根据你的用户服务实现）
        await UserRepository.SavePreferredLanguage(User.Identity.Name, cultureCode);

        // 2. 更新Cookie，确保下次请求自动加载用户文化
        var cookieValue = CookieRequestCultureProvider.MakeCookieValue(new RequestCulture(newCulture));
        HttpContextAccessor.HttpContext.Response.Cookies.Append(
            CookieRequestCultureProvider.DefaultCookieName,
            cookieValue,
            new CookieOptions { Expires = DateTimeOffset.Now.AddYears(1) }
        );
    }

    // 组件销毁时取消订阅，避免内存泄漏
    public void Dispose()
    {
        CultureState.OnCultureChanged -= () => StateHasChanged();
    }
}

4. 初始化用户文化

在App.razor或全局初始化逻辑中，从数据库加载用户的偏好语言，设置到UserCultureState：

@inject UserCultureState CultureState
@inject IUserRepository UserRepository

<Router AppAssembly="@typeof(App).Assembly">
    <!-- 路由内容 -->
</Router>

@code {
    protected override async Task OnInitializedAsync()
    {
        // 确保用户已登录
        if (User.Identity.IsAuthenticated)
        {
            var preferredCulture = await UserRepository.GetPreferredLanguage(User.Identity.Name);
            if (!string.IsNullOrEmpty(preferredCulture))
            {
                CultureState.CurrentCulture = new CultureInfo(preferredCulture);
            }
        }
    }
}

5. 本地化资源文件使用

确保资源文件命名规范，例如：

• Resources/SharedResources.resx（默认语言）
• Resources/SharedResources.en.resx（英文）
• Resources/SharedResources.zh-CN.resx（中文）
  在组件中通过IStringLocalizer<T>注入使用即可。

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