MAUI中CollectionView的RemainingItemsThresholdReached事件异常触发问题

你的问题核心是CollectionView的RemainingItemsThresholdReached事件未等滚动到列表末尾，就在初始加载完成后立即连续触发，结合其他页面逻辑正常的情况，确实大概率是当前页面的布局约束异常导致的。以下是具体排查方向和解决方案：

常见布局原因及修复 #

1. 避免将CollectionView嵌套在ScrollView中 #

CollectionView自带滚动布局逻辑，如果嵌套在ScrollView内，会导致CollectionView的高度被无限拉伸，所有列表项会被一次性渲染完成。此时剩余未显示的项数会直接低于RemainingItemsThreshold，触发加载事件。

修复：移除外层的ScrollView，让CollectionView直接作为可滚动容器填充父布局：

<!-- 错误示例：嵌套ScrollView -->
<ScrollView>
    <CollectionView ... />
</ScrollView>

<!-- 正确示例：直接使用CollectionView -->
<CollectionView 
    VerticalOptions="FillAndExpand"
    ... />

2. 确保CollectionView的高度约束正确 #

如果CollectionView的父容器（如VerticalStackLayout）未限制高度，或者CollectionView的VerticalOptions设置不当（比如设为Start），会导致CollectionView的高度仅包裹初始加载的列表项。若初始项的总高度小于等于可视区域，剩余项阈值条件会被立即触发。

修复：给CollectionView设置VerticalOptions="FillAndExpand"，让它填充父容器的可用空间，确保可视区域不足以显示所有初始加载项：

<CollectionView
    ItemsSource="{Binding Items}"
    RemainingItemsThreshold="5"
    RemainingItemsThresholdReached="OnRemainingItemsThresholdReached"
    VerticalOptions="FillAndExpand">
    <!-- 项模板定义 -->
</CollectionView>

3. 检查RemainingItemsThreshold的取值 #

如果RemainingItemsThreshold设置过大（比如等于或大于初始加载后剩余的总数据量），初始加载完成后会直接触发事件。比如总数据有30条，初始加载20条，剩余10条，若阈值设为10，就会立即触发。

修复：根据实际可视区域的项数设置合理的阈值（比如5-10），确保只有当滚动到接近末尾时才触发。

代码层面的防护措施 #

即使布局问题解决，也建议在事件处理中添加加载状态判断，防止重复触发：

private bool _isLoading = false;

private void OnRemainingItemsThresholdReached(object sender, EventArgs e)
{
    // 正在加载时直接返回，避免连续触发
    if (_isLoading) return;
    
    _isLoading = true;
    try
    {
        // 执行加载下一页数据的逻辑
        // 示例：await LoadNextPage();
    }
    finally
    {
        _isLoading = false;
    }
}

针对你Demo的排查建议 #

你的Demo中初始加载10条后立即加载下10条，可优先检查：

• 外层是否嵌套了ScrollView
• CollectionView的VerticalOptions是否设置为FillAndExpand
• 列表项的高度是否过小，导致10条项全部能在可视区域内显示

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