ASP.NET Core Blazor Scoped AppState实例意外释放问题排查

问题根源 #

Scoped类型的AppState生命周期和组件的渲染上下文绑定，如果组件没把注入的AppState实例存下来，或者订阅事件时没抓牢引用，DI容器就可能提前把它回收。另外，组件异步初始化逻辑写得不对，也会导致服务实例被意外释放。

具体修复步骤 #

1. 让组件牢牢持有AppState引用 #

别只在方法里临时用注入的AppState，在组件类里搞个私有字段存起来，避免DI容器回收实例：

@inject AppState AppState
@implements IDisposable

@code {
    private AppState _localAppState;

    protected override void OnInitialized()
    {
        _localAppState = AppState; // 保存实例引用，防止被提前回收
        _localAppState.OnChange += UpdateUI;
    }

    private void UpdateUI()
    {
        InvokeAsync(StateHasChanged); // 强制在UI线程触发界面更新
    }

    public void Dispose()
    {
        if (_localAppState != null)
        {
            _localAppState.OnChange -= UpdateUI; // 必须取消订阅，避免内存泄漏
        }
    }
}

2. 检查AppState的事件定义 #

确保OnChange是普通的强引用事件，别用弱事件模式（除非你有特殊需求）：

public class AppState
{
    public event Action OnChange;

    private bool _isLoggedIn;
    public bool IsLoggedIn
    {
        get => _isLoggedIn;
        set
        {
            if (_isLoggedIn != value)
            {
                _isLoggedIn = value;
                OnChange?.Invoke(); // 状态变更时通知所有订阅者
            }
        }
    }
}

3. 验证DI注册和渲染上下文 #

• 所有使用AppState的组件必须处于同一个渲染上下文：比如Server-Side Blazor的同一条SignalR连接，或者WASM的同一个客户端实例。如果组件用了静态渲染模式，注入Scoped服务肯定出问题。
• 禁止在单例服务、静态方法中引用Scoped的AppState，这会彻底打乱它的生命周期，要么提前被释放，要么造成内存泄漏。

4. 换用Observable模式优化订阅（可选） #

如果普通事件订阅还是不稳定，可以试试IObservable模式，借助System.Reactive库更可靠地管理订阅关系：

// 改造AppState为Observable类型
public class AppState : IObservable<bool>
{
    private readonly List<IObserver<bool>> _observers = new();
    private bool _isLoggedIn;

    public bool IsLoggedIn
    {
        get => _isLoggedIn;
        set
        {
            if (_isLoggedIn != value)
            {
                _isLoggedIn = value;
                foreach (var observer in _observers)
                {
                    observer.OnNext(value);
                }
            }
        }
    }

    public IDisposable Subscribe(IObserver<bool> observer)
    {
        _observers.Add(observer);
        return new Unsubscriber(_observers, observer);
    }

    private class Unsubscriber : IDisposable
    {
        private readonly List<IObserver<bool>> _observers;
        private readonly IObserver<bool> _observer;

        public Unsubscriber(List<IObserver<bool>> observers, IObserver<bool> observer)
        {
            _observers = observers;
            _observer = observer;
        }

        public void Dispose()
        {
            if (_observer != null && _observers.Contains(_observer))
            {
                _observers.Remove(_observer);
            }
        }
    }
}

组件内的订阅代码：

@inject AppState AppState
@implements IDisposable

@code {
    private IDisposable _subscription;

    protected override void OnInitialized()
    {
        _subscription = AppState.Subscribe(_ =>
        {
            InvokeAsync(StateHasChanged);
        });
    }

    public void Dispose()
    {
        _subscription?.Dispose(); // 销毁时取消订阅
    }
}

关键注意事项 #

• 组件必须实现IDisposable接口并在销毁时取消订阅，这不仅能避免内存泄漏，还能防止已释放的组件收到状态变更通知。
• Server-Side Blazor使用RenderMode.InteractiveServer时，确保组件的渲染模式与Scoped服务的上下文匹配，静态渲染的组件无法正确获取Scoped服务实例。

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