Blazor组件销毁时应实现IDisposable或IAsyncDisposable接口释放资源:IDisposable用于同步清理(如取消事件订阅、释放Timer),IAsyncDisposable推荐用于异步操作(如取消HTTP请求);注意Dispose中不可调用StateHasChanged,且不保证一定执行,关键资源需尽早显式释放。
Blazor 组件销毁时释放资源,核心是实现 IDisposable 或使用 IAsyncDisposable(推荐用于含异步清理的场景),并在对应方法中执行清理逻辑。
适用于取消订阅事件、释放 Timer、关闭同步流、释放非托管句柄等场景。组件继承自 ComponentBase 后,直接实现接口即可:
Dispose(bool disposing),在 disposing == true 时清理托管资源base.Dispose(disposing) 确保父类逻辑执行Dispose 中调用虚拟方法或触发状态更新(如 StateHasChanged()),此时组件已不可用示例:
public class MyComponent : ComponentBase, IDisposable
{
private Timer? _timer;
protected override void OnInitialized()
{
_timer = new Timer(_ => { /* 定时任务 */ }, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
}
public void Dispose()
{
_timer?.Dispose();
GC.SuppressFinalize(this);
}}
当需 await 异步操作(如取消 HTTP 请求、关闭 SignalR 连接、释放数据库连接池资源)时,优先实现 IAsyncDisposable:
DisposeAsync() 会在组件卸载前被框架自动调用InvokeAsync(StateHasChanged) —— 组件生命周期已结束示例:
public class DataFetcher : ComponentBase, IAsyncDisposable
{
private HttpClient _httpClient = new();
public async ValueTask DisposeAsync()
{
await _httpClient.CancelPendingRequestsAsync(); // .NET 8+
_httpClient.Dispose();
GC.SuppressFinalize(this);
}}
Blazor 不保证 Dispose 或 DisposeAsync 一定被调用(如页面强制刷新、异常中断),因此:
using 或尽早显式释放Dispose 执行业务关键逻辑(如保存用户数据),应改在用户操作或导航前完成OnParametersSet 或 OnInitialized 中重复注册资源时,先检查并清理旧实例,防止内存泄漏若组件依赖的服务本身实现了 IDisposable 或 IAsyncDisposable,且由 Blazor 的 DI 容器提供(作用域为 Scoped 或 Transient):
new 了服务实例,或用了 ActivatorUtilities.CreateInstance,就必须自己负责释放Singleton 服务中,并由该服务自身管理生命周期基本上就这些。不复杂但容易忽略的是:别在 Dispose 里搞 UI 更新,也别假设它一定会执行 —— 关键资源要“早释放、早保险”。