.NET MAUI中CollectionView的UI更新逐渐变慢问题排查

安全阿岳

2026-7-3

.NET MAUI ObservableRangeCollection 内存与UI异常排查问题

场景与代码

在.NET MAUI应用中，我有一个绑定了ObservableRangeCollection的CollectionView。出于设计考虑，我不会直接修改这个集合，而是先处理好数据列表再批量更新，代码如下：

...
var selectedStudentItems = GroupedStudentItems
    .SelectMany(groupedStudentSelectionItem => groupedStudentSelectionItem)
    .Where(StudentSelectionItem => StudentSelectionItem != null && StudentSelectionItem.IsSelected == true)
    .OrderBy(StudentSelectionItem => StudentSelectionItem.SortOrderIndex == -1 ? int.MaxValue : StudentSelectionItem.SortOrderIndex)
    .ToList();

SetSortOrderIndexBasedOnSelectedStudentItemsOrder(selectedStudentItems);

MinMaxEntryPairs.Clear();

SelectedStudentItems.Clear();
SelectedStudentItems.AddRange(selectedStudentItems);

OnPropertyChanged(nameof(SelectedStudentItems));
...

其中SelectedStudentItems是绑定到CollectionView的ObservableRangeCollection，每次更新都是先清空再添加筛选后的学生对象。

异常现象

通过以下代码检测到内存占用持续上升：

long memoryUsage = GC.GetTotalMemory(false) / (1024 * 1024);

模拟器中UI更新逐渐变慢；iPhone发布版应用无提示直接闪退。

我需要排查ObservableRangeCollection的更新是否是问题根源，是否需要切换到主线程执行更新操作。

更新：异常详情（说明为何需要重新生成集合）

运行时抛出Objective-C异常：

'Objective-C exception thrown.  Name: NSInternalInconsistencyException Reason: Invalid update: invalid number of sections. The number of sections contained in the collection view after the update (2) must be equal to the number of sections contained in the collection view before the update (2), plus or minus the number of sections inserted or deleted (1 inserted, 0 deleted). Collection view: <UICollectionView: 0x7fd1e2040200; frame = (0 0; 384 408); clipsToBounds = YES; autoresize = W+H; gestureRecognizers = <NSArray: 0x600003718930>; backgroundColor = UIExtendedGrayColorSpace 0 0; layer = <CALayer: 0x600007f4f440>; contentOffset: {0, 0}; contentSize: {384, 207}; adjustedContentInset: {0, 0, 0, 0}; layout: <Microsoft_Maui_Controls_Handlers_Items_ListViewLayout: 0x7fd1dafdbd40>; dataSource: <Microsoft_Maui_Controls_Handlers_Items_ReorderableItemsViewController_1: 0x7fd1dc229d30>>
Native stack trace:
    0   CoreFoundation                      0x00007ff8004288ab __exceptionPreprocess + 242
    1   libobjc.A.dylib                     0x00007ff80004dba3 objc_exception_throw + 48
    2   Foundation                          0x00007ff800b870cc _userInfoForFileAndLine + 0
    3   UIKitCore                           0x000000010cc935a5 -[UICollectionView _endItemAnimationsWithInvalidationContext:tentativelyForReordering:animator:collectionViewAnimator:] + 13198
    4   UIKitCore                           0x000000010cc8edab -[UICollectionView _updateSections:updateAction:] + 402
    5   UIKitCore                           0x000000010cc8ee77 -[UICollectionView insertSections:] + 64
    6   libxamarin-dotnet-debug.dylib       0x0000000108d2a149 xamarin_dyn_objc_msgSend + 217
    7   ???                                 0x0000000109298ca7 0x0 + 4448685223
    8   libmonosgen-2.0.dylib               0x00000001099793da ves_pinvoke_method + 474
    9   libmonosgen-2.0.dylib               0x000000010996b655 interp_exec_method + 3717
    10  libmonosgen-2.0.dylib               0x0000000109968e03 interp_runtime_invoke + 259
    11  libmonosgen-2.0.dylib               0x000000010978e0b8 mono_runtime_invoke_checked + 136
    12  libmonosgen-2.0.dylib               0x0000000109796ada mono_runtime_try_invoke_span + 1818
    13  libmonosgen-2.0.dylib               0x000000010974d4ec ves_icall_InternalInvoke + 284
    14  libmonosgen-2.0.dylib               0x0000000109758024 ves_icall_InternalInvoke_raw + 100
    15  libmonosgen-2.0.dylib               0x000000010997a570 do_icall + 288
    16  libmonosgen-2.0.dylib               0x00000001099790ea do_icall_wrapper + 346
    17  libmonosgen-2.0.dylib               0x000000010996b4af interp_exec_method + 3295
    18  libmonosgen-2.0.dylib               0x0000000109968e03 interp_runtime_invoke + 259
    19  libmonosgen-2.0.dylib               0x000000010978e0b8 mono_runtime_invoke_checked + 136
    20  libmonosgen-2.0.dylib               0x0000000109796ada mono_runtime_try_invoke_span + 1818
    21  libmonosgen-2.0.dylib               0x000000010974d4ec ves_icall_InternalInvoke + 284
    22  libmonosgen-2.0.dylib               0x0000000109758024 ves_icall_InternalInvoke_raw + 100
    23  libmonosgen-2.0.dylib               0x000000010997a570 do_icall + 288
    24  libmonosgen-2.0.dylib               0x00000001099790ea do_icall_wrapper + 346
    25  libmonosgen-2.0.dylib               0x000000010996b4af interp_exec_method + 3295
    26  libmonosgen-2.0.dylib               0x0000000109968e03 interp_runtime_invoke + 259
    27  libmonosgen-2.0.dylib               0x000000010978e0b8 mono_runtime_invoke_checked + 136
    28  libmonosgen-2.0.dylib               0x0000000109791d2e mono_runtime_invoke + 142
    29  libxamarin-dotnet-debug.dylib       0x0000000108d2150f xamarin_invoke_trampoline + 6335
    30  libxamarin-dotnet-debug.dylib       0x0000000108d28de9 xamarin_arch_trampoline + 105
    31  libxamarin-dotnet-debug.dylib       0x0000000108d29fca xamarin_x86_64_common_trampoline + 118
    32  UIKitCore                           0x000000010d17d3dd -[UIGestureRecognizer _componentsEnded:withEvent:] + 153
    33  UIKitCore                           0x000000010d82156d -[UITouchesEvent _sendEventToGestureRecognizer:] + 662
    34  UIKitCore                           0x000000010d16d61b -[UIGestureEnvironment _updateForEvent:window:] + 469
    35  UIKitCore                           0x000000010d7c443b -[UIWindow sendEvent:] + 5282
    36  UIKitCore                           0x000000010d797cae -[UIApplication sendEvent:] + 898
    37  UIKitCore                           0x000000010d840861 __dispatchPreprocessedEventFromEventQueue + 9381
    38  UIKitCore                           0x000000010d842f69 __processEventQueue + 8334
    39  UIKitCore                           0x000000010d8392a1 __eventFetcherSourceCallback + 272
    40  CoreFoundation                      0x00007ff800387fe5 __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 17
    41  CoreFoundation                      0x00007ff800387f24 __CFRunLoopDoSource0 + 157
    42  CoreFoundation                      0x00007ff800387721 __CFRunLoopDoSources0 + 212
    43  CoreFoundation                      0x00007ff800381e23 __CFRunLoopRun + 927
    44  CoreFoundation                      0x00007ff8003816a7 CFRunLoopRunSpecific + 560
    45  GraphicsServices                    0x00007ff809cb128a GSEventRunModal + 139
    46  UIKitCore                           0x000000010d776ad3 -[UIApplication _run] + 994
    47  UIKitCore                           0x000000010d77b9ef UIApplicationMain + 123
    48  libxamarin-dotnet-debug.dylib       0x0000000108ce464a xamarin_UIApplicationMain + 58
    49  libmonosgen-2.0.dylib               0x000000010997a5a9 do_icall + 345
    50  libmonosgen-2.0.dylib               0x00000001099790b3 do_icall_wrapper + 291
    51  libmonosgen-2.0.dylib               0x000000010996b4af interp_exec_method + 3295
    52  libmonosgen-2.0.dylib               0x0000000109968e03 interp_runtime_invoke + 259
    53  libmonosgen-2.0.dylib               0x000000010978e0b8 mono_runtime_invoke_checked + 136
    54  libmonosgen-2.0.dylib               0x00000001097960cc do_exec_main_checked + 92
    55  libmonosgen-2.0.dylib               0x00000001098c4cb2 mono_jit_exec + 354
    56  libxamarin-dotnet-debug.dylib       0x0000000108d28c77 xamarin_main + 1927
    57  MacroOptimizerApp                   0x0000000108630754 main + 68
    58  dyld                                0x00000001089c22bf start_sim + 10
    59  ???                                 0x000000011030e52e 0x0 + 4566607150
'

解决方案与排查步骤

1. 强制在主线程更新UI绑定集合

所有UI相关的集合操作必须在主线程执行，否则会导致iOS端的UI不一致异常（即上述NSInternalInconsistencyException）。修改更新代码如下：

// 切换到主线程执行集合更新
MainThread.BeginInvokeOnMainThread(() =>
{
    SelectedStudentItems.Clear();
    SelectedStudentItems.AddRange(selectedStudentItems);
    // 注意：ObservableRangeCollection本身会触发PropertyChanged，不需要手动调用
    // OnPropertyChanged(nameof(SelectedStudentItems));
});

关键：ObservableRangeCollection的Clear()和AddRange()方法会自动触发集合变更通知，手动调用OnPropertyChanged属于重复通知，可能导致UI控件接收到冲突的更新指令，引发异常。

2. 优化集合更新方式，避免频繁变更

当前的Clear()+AddRange()会触发两次集合变更通知，改用ReplaceRange()方法可以合并成一次通知，减少UI刷新次数，提升性能：

MainThread.BeginInvokeOnMainThread(() =>
{
    SelectedStudentItems.ReplaceRange(selectedStudentItems);
});

ReplaceRange()会先清空原有数据再添加新数据，只触发一次变更通知，降低UI控件的更新压力。

3. 排查内存泄漏问题

内存持续上升大概率是因为绑定的对象被UI控件或其他强引用持有，无法被GC回收：

检查StudentSelectionItem类是否实现了INotifyPropertyChanged，如果没有，绑定后可能导致控件持有强引用；
使用Visual Studio的内存分析工具（Memory Profiler）排查对象引用链，确认是否有未释放的UI绑定或事件订阅；
确保SetSortOrderIndexBasedOnSelectedStudentItemsOrder方法中没有创建额外的强引用，比如匿名委托或事件订阅未取消。

4. 解决iOS端的Section异常

你遇到的NSInternalInconsistencyException是iOS原生UICollectionView的更新一致性错误，除了确保主线程更新外，还可以尝试：

禁用CollectionView的动画：在XAML中设置CollectionView.ItemsUpdatingScrollMode = ItemsUpdatingScrollMode.KeepItemsInView，或者关闭更新动画；
如果是分组的CollectionView，确保分组数据的变更逻辑和集合更新逻辑一致，避免分组数量和实际数据不匹配；
极端情况下，可以重新实例化ObservableRangeCollection，而不是修改原有集合：
```
MainThread.BeginInvokeOnMainThread(() =>
{
    SelectedStudentItems = new ObservableRangeCollection<StudentSelectionItem>(selectedStudentItems);
    OnPropertyChanged(nameof(SelectedStudentItems));
});
```
这种方式会让UI控件完全重新绑定数据，避免增量更新的一致性问题，但性能略低于ReplaceRange()。

5. 内存检测优化

使用GC.GetTotalMemory(true)强制触发GC后再获取内存占用，这样得到的数值更准确：

long memoryUsage = GC.GetTotalMemory(true) / (1024 * 1024);

false参数不会触发GC，得到的是当前已分配内存，包含可回收的对象，参考价值较低。

内容的

.NET MAUI中CollectionView的UI更新逐渐变慢问题排查

场景与代码 #

异常现象 #

更新：异常详情（说明为何需要重新生成集合） #

1. 强制在主线程更新UI绑定集合 #

2. 优化集合更新方式，避免频繁变更 #

3. 排查内存泄漏问题 #

4. 解决iOS端的Section异常 #

5. 内存检测优化 #