MAUI中BindableProperty重复键致iOS应用崩溃问题排查求助

我有一个继承自Grid的MapGrid类，包含跨平台实现的MapView、若干标签及按钮。用户启动应用后，点击按钮打开弹出菜单，选择菜单选项后弹出菜单关闭，该Grid会在全屏ContentView中显示。

我使用Automator循环执行以下流程10分钟：打开弹出菜单>点击菜单选项>等待视图加载>关闭视图，单次循环约耗时10秒（电脑性能有限）。循环过程中应用偶尔崩溃。

崩溃报错信息 #

An item with the same key has already been added. Key: Microsoft.Maui.Controls.BindableProperty
source: "System.Private.CoreLib"

at System.Collections.Generic.Dictionary`2[[Microsoft.Maui.Controls.BindableProperty, Microsoft.Maui.Controls, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null],[Microsoft.Maui.Controls.BindableObject.BindablePropertyContext, Microsoft.Maui.Controls, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]].TryInsert(BindableProperty key, BindablePropertyContext value, InsertionBehavior behavior)
   at System.Collections.Generic.Dictionary`2[[Microsoft.Maui.Controls.BindableProperty, Microsoft.Maui.Controls, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null],[Microsoft.Maui.Controls.BindableObject.BindablePropertyContext, Microsoft.Maui.Controls, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]].Add(BindableProperty key, BindablePropertyContext value)
   at Microsoft.Maui.Controls.BindableObject.SetValueCore(BindableProperty property, Object value, SetValueFlags attributes, SetValuePrivateFlags privateAttributes)
   at Microsoft.Maui.Controls.MultiBinding.Apply(Boolean fromTarget)
   at Microsoft.Maui.Controls.MultiBinding.OnBindingChanged(BindableObject bindable, Object oldValue, Object newValue)
   at Microsoft.Maui.Controls.BindableObject.SetValueActual(BindableProperty property, BindablePropertyContext context, Object value, Boolean currentlyApplying, SetValueFlags attributes, Boolean silent)
   at Microsoft.Maui.Controls.BindableObject.SetValueCore(BindableProperty property, Object value, SetValueFlags attributes, SetValuePrivateFlags privateAttributes)
   at Microsoft.Maui.Controls.BindingExpression.ApplyCore(Object sourceObject, BindableObject target, BindableProperty property, Boolean fromTarget)
   at Microsoft.Maui.Controls.BindingExpression.Apply(Boolean fromTarget)
   at Microsoft.Maui.Controls.BindingExpression.BindingExpressionPart.<PropertyChanged>b__49_0()
   at Microsoft.Maui.Dispatching.Dispatcher.<>c__DisplayClass9_0.<DispatchImplementation>b__0()
   at CoreFoundation.DispatchQueue.static_dispatcher_to_managed(IntPtr context)
   at UIKit.UIApplication.UIApplicationMain(Int32 argc, String[] argv, IntPtr principalClassName, IntPtr delegateClassName)
   at UIKit.UIApplication.Main(String[] args, Type principalClass, Type delegateClass)
   at meescan.Platforms.IOS.Program.Main(String[] args) in /Users/eamonn.alphin/Documents/git/meescan/Platforms/iOS/Program.cs:line 14

已尝试的修复措施 #

怀疑问题与MapView未释放有关，添加了以下代码：

this.Unloaded += (s,e) =>{
    this.Clear()
}

mapview.Unloaded += (s,e) =>{
     mapView?.Handler?.DisconnectHandler();
}

但问题仍存在，崩溃时间不定（2-8分钟不等）。已排查动态资源重复键问题，确认该问题仅出现在此视图，调用的视图模型、动态资源生成类等均无异常。

开发环境 #

• .NET 6.0
• 6.7英寸iOS 16.0模拟器
• macOS Ventura系统
• Visual Studio Preview 17.4 build 2326

可能的崩溃原因 #

• 自定义BindableProperty非静态导致重复实例：如果MapGrid或其内部控件的自定义BindableProperty不是static readonly修饰，每次实例化控件都会生成新的属性实例，重复绑定操作会触发字典重复键冲突。
• MultiBinding未彻底清理：堆栈指向MultiBinding.Apply，说明视图销毁时MultiBinding的绑定关系未完全解除，旧绑定的回调在新视图实例化时触发，重复操作属性字典。
• MapView资源泄漏未彻底解决：仅调用DisconnectHandler可能不足以释放iOS原生资源（如MKMapView），导致Managed对象被保留，重复创建时引发属性冲突。
• 线程安全问题：崩溃发生在Dispatcher回调中，可能存在后台线程与UI线程同时操作BindableProperty的情况，而Dictionary本身不具备线程安全性，引发并发冲突。

调试与修复建议 #

• 检查自定义BindableProperty定义：确保所有自定义BindableProperty均为static readonly，避免每次实例化控件创建新属性实例。
• 增强视图销毁时的绑定清理：在MapGrid的Unloaded事件中主动清理所有绑定：

  this.Unloaded += (s, e) => {
      // 清理所有自定义BindableProperty的绑定值
      foreach (var field in this.GetType().GetFields(BindingFlags.Static | BindingFlags.Public)
                  .Where(f => f.FieldType == typeof(BindableProperty)))
      {
          if (field.GetValue(null) is BindableProperty prop)
          {
              this.ClearValue(prop);
          }
      }
      // 移除所有子控件
      this.Clear();
  };
  

• 完善MapView的资源释放：除了断开Handler，还需清空绑定上下文、移除事件订阅并从父容器移除：

  mapview.Unloaded += (s, e) => {
      mapView.BindingContext = null;
      // 移除所有自定义事件订阅（需对应添加时的引用）
      mapView.Handler?.DisconnectHandler();
      mapView.Handler = null;
      if (mapView.Parent is Layout parentLayout)
      {
          parentLayout.Remove(mapView);
      }
  };
  

• 内存泄漏排查：使用Visual Studio的内存快照工具，每次循环后拍摄快照，对比MapGrid、MapView实例是否被正确回收，定位未释放的对象。
• 添加实例跟踪日志：在MapGrid的构造函数、Unloaded事件中记录实例的HashCode，确认每次关闭视图后实例是否被回收，是否存在重复操作同一属性的情况。
• 确保UI操作在主线程执行：检查所有更新BindableProperty的代码，确保统一在UI线程（Dispatcher）中执行，避免并发冲突。
• 升级MAUI版本：当前使用的.NET 6 + VS Preview版本可能存在已知的绑定内存泄漏问题，尝试升级到.NET 7或更高版本的MAUI，验证问题是否解决。

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