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 在生命周期方法结束后自动刷新）。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 避免在其中直接修改 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 组件。
