Blazor组件生命周期包含初始化、参数设置、渲染更新、销毁四个阶段,各阶段均有同步/异步成对方法供重写:OnInitialized/Async用于首次准备;OnParametersSet/Async响应参数变更;OnAfterRender/Async在每次渲染后执行;IDisposable/Async实现资源清理。

Blazor组件生命周期是一套有序的、可重写的虚方法调用序列,贯穿组件从创建、参数绑定、渲染到销毁的全过程。它不是一次性触发的事件流,而是按明确顺序分阶段执行的逻辑钩子,开发者通过重写这些方法,在关键节点插入自定义行为。
初始化阶段:组件诞生与首次准备
组件实例化后立即进入初始化阶段,核心是两个成对方法:
- OnInitialized:同步方法,在构造函数之后、参数设置前执行,适合轻量初始化(如设默认状态、订阅本地事件);
- OnInitializedAsync:异步对应方法,仅执行一次,专用于加载初始数据(如调用API、读取配置),会阻塞首次渲染直到完成。
注意:此时[Parameter]属性尚未赋值,不能依赖传入参数做判断或请求。
参数设置阶段:响应输入变化
每当父组件传参更新(包括首次绑定),Blazor都会调用参数相关方法:
- OnParametersSet:同步执行,适合快速响应参数变更(如刷新UI开关、重置内部计数器);
- OnParametersSetAsync:异步执行,常用于根据新参数发起数据查询(如搜索关键词变化后调用SearchAsync)。
这个阶段可能被多次触发,比如路由参数改变、父组件重渲染并传入新值,是处理“外部驱动更新”的主入口。
渲染与更新阶段:呈现与后续操作
每次组件完成一次完整渲染后,都会调用:
Android开发指南中文pdf版,学习android的朋友可以参考下。应用程序基础Application Fundamentals 关键类 应用程序组件 激活组件:intent 关闭组件 manifest文件 Intent过滤器 Activity和任务 Affinity(吸引力)和新任务 加载模式 清理堆栈 启动任务 进程和线程 进程 线程 远程过程调用 线程安全方法 组件生命周期 Activity生命周期 调用父类 服务生命周期 广播接收器生命周期 进程与生命周期 用户界面User Interface
- OnAfterRender(bool firstRender):同步方法,firstRender为true表示这是首次渲染,可用于操作DOM(如聚焦输入框、初始化JS库);
- OnAfterRenderAsync(bool firstRender):异步版本,适合在渲染后执行延迟任务(如日志上报、动画启动)。
这两个方法在每次渲染后都执行(包括因StateHasChanged触发的重渲染),需配合ShouldRender合理控制,避免无限循环。
销毁阶段:资源清理不可少
组件卸载时不会自动调用Dispose——必须显式声明接口:
- 在.razor文件顶部添加
@implements IDisposable或@implements IAsyncDisposable; - 实现
void Dispose()或ValueTask DisposeAsync(),释放订阅、取消定时器、关闭连接等; - 同步与异步清理方法不会同时存在,选其一即可,框架会按需调用。
不实现IDisposable可能导致内存泄漏,尤其在频繁挂载/卸载的组件(如Tab页、弹窗)中要特别注意。
基本上就这些。五个核心阶段覆盖了绝大多数场景,同步/异步成对设计让逻辑更可控,而方法调用顺序固定、不可跳过,理解它们的触发时机比死记名称更重要。








