iOS/MacCatalyst下MAUI分组CollectionView返回后显示空分组

我开发的MAUI应用中，视图绑定的ViewModel包含一个分组CollectionView，配置代码如下。首次进入视图、切换筛选开关时，从Web API获取并分组的数据显示正常；但通过Shell导航至详情页再返回后，再次切换筛选并重新加载数据，iOS和MacCatalyst平台会出现仅显示分组头的空分组，Android和WinUI平台无此问题。

我已尝试的操作：

• 每次加载数据都会重置CollectionViewItemSourceGrouped为新实例
• 尝试更换容器控件

目前仅设置固定HeightRequest能临时解决，但无法适配所有设备。

ViewModel核心代码 #

public ObservableCollection<GroupedItem> CollectionViewItemSourceGrouped { get; set; } = new();

public async Task LoadData(bool filterEnabled)
{
    // 从API获取数据
    var rawData = await ApiService.GetItems(filterEnabled);
    // 分组处理
    var groupedData = rawData.GroupBy(item => item.Category)
                             .Select(g => new GroupedItem(g.Key, g.ToList()))
                             .ToList();
    // 重置为新实例
    CollectionViewItemSourceGrouped = new ObservableCollection<GroupedItem>(groupedData);
    OnPropertyChanged(nameof(CollectionViewItemSourceGrouped));
}

XAML核心配置 #

<CollectionView x:Name="MyCollectionView"
                ItemsSource="{Binding CollectionViewItemSourceGrouped}"
                IsGrouped="True">
    <CollectionView.GroupHeaderTemplate>
        <DataTemplate>
            <Label Text="{Binding Key}"
                   FontSize="Headline"
                   BackgroundColor="LightGray"
                   Padding="10"/>
        </DataTemplate>
    </CollectionView.GroupHeaderTemplate>
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Label Text="{Binding Name}"
                   Padding="15,5"/>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

可能的解决方案 #

1. 强制CollectionView刷新布局
   在视图的OnAppearing方法中手动触发布局刷新，解决返回后UI未重新计算的问题：

protected override void OnAppearing()
{
    base.OnAppearing();
    MyCollectionView?.InvalidateMeasure();
    MyCollectionView?.ForceLayout();
}

2. 替换实例后强制通知UI刷新
   保留重置为新实例的逻辑，但额外触发CollectionView的布局更新，可通过消息中心实现：

// ViewModel中加载数据后发送消息
public async Task LoadData(bool filterEnabled)
{
    var rawData = await ApiService.GetItems(filterEnabled);
    var groupedData = rawData.GroupBy(item => item.Category)
                             .Select(g => new GroupedItem(g.Key, g.ToList()))
                             .ToList();

    CollectionViewItemSourceGrouped = new ObservableCollection<GroupedItem>(groupedData);
    OnPropertyChanged(nameof(CollectionViewItemSourceGrouped));
    MessagingCenter.Send(this, "RefreshCollectionLayout");
}

// 视图中订阅消息
public MainPage()
{
    InitializeComponent();
    MessagingCenter.Subscribe<MainViewModel>(this, "RefreshCollectionLayout", (_) =>
    {
        MyCollectionView.InvalidateMeasure();
    });
}

3. 验证分组数据完整性
   在加载数据时添加日志，确认返回视图后分组的子项数量是否正常，排除数据本身为空的情况：

foreach (var group in groupedData)
{
    Debug.WriteLine($"分组[{group.Key}]包含{item.Items.Count}个子项");
}

4. 让分组类实现INotifyPropertyChanged
   确保分组对象的子项集合变化时能通知UI，避免因绑定未更新导致的空显示：

public class GroupedItem : ObservableObject
{
    private string _key;
    private ObservableCollection<Item> _items;

    public string Key
    {
        get => _key;
        set => SetProperty(ref _key, value);
    }

    public ObservableCollection<Item> Items
    {
        get => _items;
        set => SetProperty(ref _items, value);
    }

    public GroupedItem(string key, IEnumerable<Item> items)
    {
        _key = key;
        _items = new ObservableCollection<Item>(items);
    }
}

5. 排查平台特定渲染问题
   如果以上方法无效，可能是MAUI在iOS/MacCatalyst平台的渲染bug。可以尝试降级到稳定版本，或在官方仓库提交问题反馈（附带可复现示例）。

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