Blazor Server：初学者如何选择同步/异步生命周期方法

核心原则一句话：只要你的逻辑里需要等待异步操作（比如调用API、数据库查询、异步文件IO这些），就用异步版本；如果只是纯内存操作、同步计算，直接用同步版本就行。

下面针对每对生命周期方法具体说场景：

1. OnInitialized() vs OnInitializedAsync() #

• 用OnInitialized()：组件初始化时只做同步操作，比如初始化本地变量、设置静态配置、纯内存数据处理。
  示例代码：

  protected override void OnInitialized()
  {
      // 初始化本地列表
      TodoItems = new List<Todo> { new Todo { Title = "默认事项" } };
      // 设置初始状态
      IsEditing = false;
  }
  

• 用OnInitializedAsync()：初始化需要拉取远程数据、调用异步服务方法，比如从API拿初始数据、查询数据库。
  示例代码：

  protected override async Task OnInitializedAsync()
  {
      // 调用异步服务获取待办事项
      TodoItems = await _todoService.GetAllTodosAsync();
      IsLoading = false;
  }
  

2. OnParametersSet() vs OnParametersSetAsync() #

• 用OnParametersSet()：参数更新后只做同步处理，比如根据新参数计算本地值、同步更新组件状态，没有需要等待的操作。
  示例代码：

  [Parameter] public int CategoryId { get; set; }
  private string CategoryLabel { get; set; }
  
  protected override void OnParametersSet()
  {
      // 根据传入的ID同步生成显示标签
      CategoryLabel = CategoryId switch
      {
          1 => "工作",
          2 => "生活",
          _ => "其他"
      };
  }
  

• 用OnParametersSetAsync()：参数变化后需要触发异步操作，比如根据新的参数ID重新从API拉取对应数据、异步更新关联状态。
  示例代码：

  [Parameter] public int CategoryId { get; set; }
  private List<Todo> FilteredTodos { get; set; }
  
  protected override async Task OnParametersSetAsync()
  {
      // 分类ID变化时，异步获取对应分类的待办事项
      if (CategoryId != 0)
      {
          FilteredTodos = await _todoService.GetTodosByCategoryAsync(CategoryId);
      }
  }
  

3. OnAfterRender() vs OnAfterRenderAsync() #

• 用OnAfterRender()：组件渲染完成后做同步的DOM操作（Blazor里尽量少直接操作DOM，但如果要做，比如简单样式修改、同步读取DOM属性），或者纯内存状态收尾。
  示例代码：

  protected override void OnAfterRender(bool firstRender)
  {
      if (firstRender)
      {
          // 同步调用JS设置元素样式
          _jsRuntime.InvokeVoid("updateElementStyle", "todoContainer", "padding", "10px");
      }
  }
  

• 用OnAfterRenderAsync()：渲染后需要执行异步DOM操作、等待异步JS互操作结果，或者首次渲染后启动异步后台任务（比如定时刷新数据）。
  示例代码：

  protected override async Task OnAfterRenderAsync(bool firstRender)
  {
      if (firstRender)
      {
          // 异步获取DOM元素的高度
          var containerHeight = await _jsRuntime.InvokeAsync<int>("getElementHeight", "todoContainer");
          ContainerHeight = containerHeight;
          // 启动定时异步刷新任务
          _refreshTimer = new Timer(async _ => await RefreshTodoListAsync(), null, TimeSpan.Zero, TimeSpan.FromMinutes(3));
      }
  }
  

额外注意点 #

• 异步方法里绝对别用Task.Wait()或Task.Result()，Blazor Server的同步上下文是单线程的，阻塞会导致死锁。
• 别为了用异步而用异步：如果异步方法里没有真正的异步操作（比如只是返回Task.CompletedTask），直接用同步版更高效。
• 首次渲染时的异步操作（比如OnInitializedAsync）会让组件处于加载状态，直到异步任务完成后重新渲染。

内容的提问来源于stack exchange，提问作者sukesh