Blazor Server中QuickGrid的ItemsProvider重复触发问题排查

问题根源分析 #

1. 分页时两次触发：Blazor Server的组件渲染机制叠加QuickGrid内部状态同步逻辑，可能导致初始化或状态变更时的双重渲染，进而重复调用ItemsProviderTestModel1。
2. 外部模态框按钮触发：模态框的显示状态（如ShowModal布尔变量）若定义在包含QuickGrid的父组件中，切换状态会触发父组件重渲染，而QuickGrid的ItemsProvider会在组件渲染时默认执行。排序/搜索后状态进入稳定期，因此不会重复触发。

具体解决办法 #

1. 基于参数缓存查询结果 #

创建本地缓存，以分页、排序、搜索参数的组合作为判断依据，仅当参数变化时才执行真实数据查询，避免重复请求：

private GridItemsProviderResult<YourModel>? _cachedResult;
private GridSort<YourModel>? _lastSort;
private int _lastPageIndex;
private int _lastPageSize;
private string? _lastSearchTerm;

private async ValueTask<GridItemsProviderResult<YourModel>> ItemsProviderTestModel1(GridItemsProviderRequest<YourModel> request)
{
    // 对比当前参数与上次缓存的参数，一致则直接返回缓存
    if (_cachedResult != null 
        && _lastSort?.Equals(request.Sort) == true
        && _lastPageIndex == request.StartIndex / request.Count
        && _lastPageSize == request.Count
        && _lastSearchTerm == CurrentSearchTerm)
    {
        return _cachedResult;
    }

    // 实际数据获取逻辑
    var dataResult = await YourDataService.GetPagedData(
        pageIndex: request.StartIndex / request.Count,
        pageSize: request.Count,
        sortRules: request.Sort,
        searchKeyword: CurrentSearchTerm
    );

    // 更新缓存与参数记录
    _cachedResult = new GridItemsProviderResult<YourModel>(dataResult.Items, dataResult.TotalCount);
    _lastSort = request.Sort;
    _lastPageIndex = request.StartIndex / request.Count;
    _lastPageSize = request.Count;
    _lastSearchTerm = CurrentSearchTerm;

    return _cachedResult;
}

2. 隔离模态框状态，减少父组件重渲染 #

将模态框封装为独立组件，通过CascadingValue或独立状态容器管理显示状态，避免父组件整体重渲染波及QuickGrid。也可给QuickGrid添加@key指令，仅当关键参数变化时才重新渲染组件：

<QuickGrid ItemsProvider="ItemsProviderTestModel1" 
           @key="@($"{CurrentSearchTerm}-{_lastSort?.ToString()}-{_lastPageIndex}")">
    <!-- 列定义 -->
</QuickGrid>

3. 重写ShouldRender控制渲染时机 #

在包含QuickGrid的组件中重写ShouldRender，仅当影响数据的参数变化时允许渲染：

protected override bool ShouldRender()
{
    // 仅当搜索词、排序规则、页码变化时才渲染
    return _lastSearchTerm != CurrentSearchTerm 
           || !_lastSort?.Equals(CurrentSort) == true
           || _lastPageIndex != CurrentPageIndex;
}

4. 清理冗余初始化逻辑 #

检查组件的OnInitializedAsync、OnAfterRenderAsync方法，避免手动触发不必要的数据刷新；同时确认QuickGrid的分页参数绑定无重复，防止状态异常变更。

关键注意事项 #

• 缓存键需覆盖所有影响数据结果的参数，确保参数变更时能及时获取最新数据。
• 仅在数据实际发生增删改时调用RefreshDataAsync，避免无意义的重复请求。

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