.NET MAUI 中 ApplyStyleSheets() 方法引发的集合修改异常分析

问题概述

在 .NET MAUI 项目中，开发者在 Android 平台上遇到了一个由 ApplyStyleSheets() 方法引发的 System.InvalidOperationException 异常。该异常的具体错误信息为："Collection was modified; enumeration operation may not execute"，即在对集合进行枚举操作时，集合被修改了。

异常背景

这个异常发生在页面导航过程中，具体是在样式表应用的过程中。当 MAUI 框架尝试遍历可视化树并应用样式表时，集合被意外修改，导致枚举操作失败。

技术细节分析

异常调用栈

从调用栈可以看出，问题起源于 Element.ApplyStyleSheets() 方法。该方法递归地遍历可视化树，为每个元素应用样式表。关键问题出现在以下代码段：

foreach (var child in element.GetVisualChildren())
{
    // 处理子元素的逻辑
}

根本原因

在 .NET 中，foreach 循环使用枚举器来遍历集合。如果在枚举过程中集合被修改（添加、删除元素等），就会抛出 InvalidOperationException。这是 .NET 集合操作的基本安全机制。

在 MAUI 的场景中，可能发生在以下情况：

1. 样式应用过程中触发了布局更新
2. 导航操作导致页面树结构变化
3. 异步操作干扰了可视化树的遍历

解决方案探讨

针对这个问题，有几种可能的解决方案：

1. 使用 ToList() 创建集合副本： 修改代码为 foreach (var child in element.GetVisualChildren().ToList())，这样可以避免在枚举过程中原始集合被修改的问题。

2. 使用索引循环： 将 foreach 循环改为传统的 for 循环，通过索引访问集合元素。

3. 添加同步锁： 如果问题是多线程导致的，可以考虑添加适当的同步机制。

最佳实践建议

1. 集合遍历安全： 在遍历可能被修改的集合时，始终考虑创建副本或使用安全的遍历方式。

2. 样式应用优化： 对于复杂的样式应用场景，可以考虑分批处理或使用更高效的样式应用策略。

3. 错误处理： 在样式应用的关键路径上添加适当的错误处理和恢复机制。

结论

这个问题的本质是集合遍历与修改的并发冲突，在 UI 框架中尤为常见。通过创建集合副本或改变遍历方式，可以有效避免此类异常。对于 MAUI 开发者来说，理解可视化树的操作时机和样式应用机制，有助于编写更健壮的跨平台应用代码。