Blazor Server中StateHasChanged触发InvalidOperationException问题咨询

问题根源 #

你遇到的InvalidOperationException，核心原因是静态类的全局特性与Blazor Server组件的上下文绑定冲突：

• Blazor Server的组件实例是绑定到单个用户的电路（Circuit）和渲染上下文的，每个用户会话对应独立的组件实例集合。
• 静态类是全局共享的，所有用户的组件都会注册到同一个静态事件上。当事件触发时，可能出现两种情况：
  1. 触发事件的线程不是Blazor的UI线程，直接调用StateHasChanged违反了Blazor的线程安全要求；
  2. 某个组件实例已经被销毁（比如用户导航离开），但静态事件的订阅未取消，此时调用StateHasChanged时，组件的渲染上下文已失效，直接抛出异常。

服务类事件更优的原因 #

用Scoped服务（Blazor Server默认服务作用域为Per Circuit）替代静态类，完全适配Blazor的运行机制：

• 上下文匹配：每个用户会话对应一个独立的Scoped服务实例，组件订阅的是当前会话内服务的事件，不会跨用户/跨电路触发，确保事件只关联当前用户的有效组件实例。
• 线程安全保障：服务内的事件触发通常在Blazor的UI线程环境中，即使在后台线程触发，也可以通过InvokeAsync轻松切换到UI线程执行StateHasChanged，避免线程异常。
• 内存泄漏风险低：组件可以在Dispose方法中取消对服务事件的订阅，而静态类的订阅如果未及时清理，会持续持有已销毁的组件实例，导致内存泄漏，进而引发更多未知异常。

你的绕过方案的隐患 #

触发主布局重新渲染虽然能暂时解决报错，但存在明显问题：

• 不必要的性能开销：强制整个布局下的所有组件重新渲染，会增加UI线程的负担，影响用户体验；
• 未解决根源问题：静态类的无效订阅依然存在，随着用户会话增多，内存泄漏和异常风险会持续积累。

正确实现建议 #

1. 将静态类替换为Scoped服务，在服务内定义数据变更事件：

public class DataService : IDisposable
{
    public event EventHandler DataChanged;

    public void UpdateData()
    {
        // 数据更新逻辑
        DataChanged?.Invoke(this, EventArgs.Empty);
    }

    // 按需实现Dispose逻辑
    public void Dispose()
    {
        // 清理事件订阅
        DataChanged = null;
    }
}

2. 在组件中注册/取消服务事件：

@inject DataService DataService
@implements IDisposable

protected override void OnInitialized()
{
    DataService.DataChanged += OnDataChanged;
}

private void OnDataChanged(object sender, EventArgs e)
{
    // 确保在UI线程调用StateHasChanged
    InvokeAsync(StateHasChanged);
}

public void Dispose()
{
    DataService.DataChanged -= OnDataChanged;
}

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