OnInitializedAsync 是 Blazor 组件生命周期中第一个异步初始化入口，它在组件首次渲染前执行，且只调用一次。这个方法适合做需要等待异步操作完成才能继续渲染的初始化工作，比如从服务端加载初始数据、读取本地存储、或检查用户认证状态。
什么时候该用 OnInitializedAsync？
当你需要在组件显示前就获取数据，并且这些操作是异步的（如 HTTP 请求、await 读取 JS 运行时值），就应该放在 OnInitializedAsync 中。它比 OnInitialized 更常用，因为多数初始化逻辑都涉及异步调用。
首次进入页面时拉取列表数据（如用户订单、文章列表） 根据路由参数发起异步查询（需配合NavigationManager或参数绑定） 检查登录态或权限（调用认证服务并 await） 初始化第三方 JS 库（通过
IJSRuntime调用并等待就绪）
和 OnInitialized 的关键区别
OnInitialized 是同步方法，不能 await；而 OnInitializedAsync 返回
Task，支持 await。Blazor 会自动等待它完成后再进行首次渲染。如果两者都实现，OnInitialized 先执行，接着才是 OnInitializedAsync。 不要在 OnInitialized 里写
await—— 编译会报错 若只需同步初始化（如设置字段默认值），用 OnInitialized 更轻量 Blazor 不会重试失败的 OnInitializedAsync，异常会导致组件渲染中断（显示错误页或空白），建议加 try/catch 并设置加载/错误状态
常见写法与注意事项
典型结构是声明一个私有字段保存数据，用 OnInitializedAsync 加载它，再触发重新渲染（通常靠
StateHasChanged()不需要手动调，因为 Blazor 在生命周期方法结束后自动刷新）。 避免在其中直接修改 UI 状态后不通知更新（一般不需要手动调
StateHasChanged，除非你在后台线程或回调中更新） 注意取消令牌（
CancellationToken）的使用，尤其在组件销毁前请求可能还在进行，应传入并响应取消 如果组件被复用（如路由参数变化但组件实例未重建），OnInitializedAsync 不会再次执行 —— 此时应改用 OnParametersSetAsync
简单示例
假设加载一个待办列表：
protected override async Task OnInitializedAsync()
{
try
{
isLoading = true;
todos = await todoService.GetTodosAsync();
}
catch (Exception ex)
{
errorMessage = "加载失败：" + ex.Message;
}
finally
{
isLoading = false;
}
}
配合 UI 显示加载中或错误提示，就能提供流畅的首屏体验。
基本上就这些。掌握 OnInitializedAsync 的触发时机和适用边界，能帮你写出更可靠、响应及时的 Blazor 组件。
