为何相同调用逻辑下StateHasChanged()触发OnAfterRenderAsync次数不同？

SetProperty方法定义 #

public void SetProperty(ComponentBase caller, string PropertyName, object PropertyValue, bool SaveChanges = true)
{
    try
    {
        var prop = this.GetType().GetProperty(PropertyName);
        if (prop != null)
        {
            this.Caller = caller.GetType().Name;
            prop.SetValue(this, PropertyValue);
            if (SaveChanges)
            {
                this.SaveChanges();
            }
            StateHasChanged();
        }
    }
    catch (Exception ex)
    {
    }
}

两处调用代码 #

第一处调用 #

AppState.SetProperty(this, "SelectedInvestmentId", investmentId, true);
AppState.SetProperty(this, "CurrentEntityType", "Investment", false);
AppState.SetProperty(this, "CurrentEntityId", investmentId, false);
AppState.SetProperty(this, "CurrentEntityName", selectedModel.InvestmentName, false);

第二处调用 #

AppState.SetProperty(this, "SelectedInvestmentId", investmentId, true);
AppState.SetProperty(this, "CurrentEntityType", "Investment", false);
AppState.SetProperty(this, "CurrentEntityId", investmentId, false);
AppState.SetProperty(this, "CurrentEntityName", workingModel.InvestmentName, false);

核心疑问 #

第一处调用时，StateHasChanged()执行了四次，但仅触发一次OnAfterRenderAsync；第二处调用时，四次调用会触发四次OnAfterRenderAsync。为何相同代码下StateHasChanged的行为存在差异？

这种差异的核心原因在于Blazor的渲染批次处理逻辑，以及两次调用所处的执行上下文不同：

• 第一处调用的同步上下文特性：
  第一处调用大概率处于Blazor的同步执行流中（比如组件生命周期方法OnInitializedAsync/OnParametersSetAsync的同步段、同步事件处理程序内）。Blazor会自动合并同一同步执行流中的多次StateHasChanged请求，将其批量处理为一次完整渲染周期，最终只触发一次OnAfterRenderAsync。
  另外，第一处第一个SetProperty传入SaveChanges = true，如果SaveChanges是同步操作，四次调用会在同一个同步栈中完成，渲染批次机制完全生效。

• 第二处调用的异步上下文特性：
  第二处调用可能处于异步执行上下文（比如在async方法中，之前存在await操作导致执行流拆分），或者SaveChanges方法在此处是异步实现（即使未显式await，异步方法本身会导致后续调用进入不同执行流）。
  当StateHasChanged在独立的异步执行批次中被调用时，Blazor无法合并这些渲染请求，会触发四次独立的渲染周期，对应四次OnAfterRenderAsync。

• 关键验证点：

  • 检查两处调用所在方法是否为async，是否存在await语句拆分执行流；
  • 确认SaveChanges的实现差异：若第一处为同步操作、第二处为异步操作，会直接导致执行上下文断裂，无法合并渲染；
  • Blazor的渲染批次仅在同步执行流或同一异步延续上下文中生效，执行流被await拆分后，后续StateHasChanged会触发独立渲染。

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