Server-Side Blazor多语言与CircuitHandler冲突：会话间语言串改问题

问题根源 #

你遇到的现象本质是语言设置被全局共享。Server-Side Blazor中，单例（Singleton）服务、静态变量会被所有Circuit（用户会话）共用。如果你的语言配置存在这类全局存储中，新用户的浏览器语言设置会覆盖全局值，导致所有已连接用户的页面语言同步切换。

具体来说：

• 默认注册的CircuitHandler是单例，若在其中修改全局语言状态，会影响所有会话
• 若本地化服务或语言存储用了单例/静态实现，所有Circuit都会访问同一个实例

解决方案 #

1. 为每个Circuit独立存储语言信息 #

利用Blazor的Circuit.CircuitState——这是每个Circuit独有的字典，专门用于存储当前会话的状态数据。在CircuitHandler中处理连接时，从请求头获取浏览器语言并存入当前Circuit的State：

public class CustomCircuitHandler : CircuitHandler
{
    public override async Task OnConnectionUpAsync(Circuit circuit, CancellationToken cancellationToken)
    {
        // 从请求头获取浏览器首选语言
        var acceptLangHeader = circuit.HttpContext.Request.Headers["Accept-Language"].ToString();
        var userLang = string.IsNullOrEmpty(acceptLangHeader) ? "en" : acceptLangHeader.Split(',')[0];
        
        // 存入当前Circuit的专属状态
        circuit.CircuitState["CurrentLanguage"] = userLang;
        
        // 在线用户数统计逻辑（基于Circuit数量，确保独立统计）
        await base.OnConnectionUpAsync(circuit, cancellationToken);
    }

    public override async Task OnConnectionDownAsync(Circuit circuit, CancellationToken cancellationToken)
    {
        // 移除当前Circuit的语言状态（可选）
        circuit.CircuitState.Remove("CurrentLanguage");
        
        // 在线用户数递减逻辑
        await base.OnConnectionDownAsync(circuit, cancellationToken);
    }
}

2. 本地化服务改用Scoped注册 #

确保本地化相关服务是Scoped生命周期（每个Circuit对应一个实例），避免全局共享：

// Program.cs中注册
builder.Services.AddScoped<ILocalizationService, CustomLocalizationService>();

在自定义本地化服务中，从当前Circuit的State读取语言，而非全局变量：

public class CustomLocalizationService : ILocalizationService
{
    private readonly CircuitAccessor _circuitAccessor;

    public CustomLocalizationService(CircuitAccessor circuitAccessor)
    {
        _circuitAccessor = circuitAccessor;
    }

    public string GetCurrentLanguage()
    {
        return _circuitAccessor.Circuit?.CircuitState["CurrentLanguage"] as string ?? "en";
    }

    // 其他本地化方法...
}

3. 组件中获取当前会话的语言 #

在Blazor组件中，通过CircuitAccessor获取当前Circuit，进而读取专属语言设置：

@inject CircuitAccessor CircuitAccessor
@inject ILocalizationService LocalizationService

<h1>@LocalizationService.GetLocalizedString("Welcome")</h1>

@code {
    protected override void OnInitialized()
    {
        var currentLang = LocalizationService.GetCurrentLanguage();
        // 基于语言加载对应资源
    }
}

4. 清理全局静态语言存储 #

检查代码中是否存在类似public static string CurrentLanguage { get; set; }的静态变量，这类全局存储会导致会话间干扰，必须替换为Per-Circuit的存储方式。

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