OnInitializedAsync 是 Blazor 组件首次渲染前唯一异步初始化入口，适用于加载数据、检查认证、调用 JS 等需 await 的操作；它返回 Task，支持异步等待，而 OnInitialized 仅支持同步逻辑，两者共存时前者后执行。
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 在生命周期方法结束后自动刷新）。
Android开发指南中文pdf版,学习android的朋友可以参考下。应用程序基础Application Fundamentals 关键类 应用程序组件 激活组件：intent 关闭组件 manifest文件 Intent过滤器 Activity和任务 Affinity（吸引力）和新任务 加载模式 清理堆栈 启动任务 进程和线程 进程 线程 远程过程调用 线程安全方法 组件生命周期 Activity生命周期 调用父类 服务生命周期 广播接收器生命周期 进程与生命周期 用户界面User Interface
- 避免在其中直接修改 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 组件。
