.NET MAUI向ObservableCollection添加数据时触发COMException问题

可能触发COMException的原因 #

• TeamListModel不符合绑定规范：没实现INotifyPropertyChanged接口，或者属性不是公共访问、缺少正确的get/set方法。WPF/UWP的绑定系统对模型类有严格要求，不符合的话容易触发底层COM异常。
• 线程违规操作：ObservableCollection是UI线程敏感的集合类，如果在非UI线程直接实例化或修改，会触发跨线程的COM错误。
• TeamListModel内部有未正确初始化的COM依赖：如果模型类里用到了COM对象相关的属性，构造时没正确初始化这些对象，会直接抛出COMException。
• XAML绑定提前加载：页面的CollectionView在ViewModel完成初始化前就尝试绑定集合，导致集合创建时上下文异常。

对应的解决步骤 #

1. 给TeamListModel加上INotifyPropertyChanged实现
   这是WPF/UWP绑定的基础要求，示例代码：

   public class TeamListModel : INotifyPropertyChanged
   {
       private string _teamName;
       public string TeamName
       {
           get => _teamName;
           set
           {
               _teamName = value;
               OnPropertyChanged();
           }
       }
   
       public event PropertyChangedEventHandler PropertyChanged;
       protected void OnPropertyChanged([CallerMemberName] string propertyName = null)
       {
           PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
       }
   }
   

2. 强制在UI线程创建/修改ObservableCollection
   如果是从后台服务获取数据，必须切换到UI线程操作集合：

   // WPF环境用Dispatcher
   Application.Current.Dispatcher.Invoke(() =>
   {
       TeamsCollection = new ObservableCollection<TeamListModel>(yourHardcodedData);
   });
   
   // UWP环境用CoreDispatcher
   await Windows.ApplicationModel.Core.CoreApplication.MainView.CoreWindow.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
   {
       TeamsCollection = new ObservableCollection<TeamListModel>(yourHardcodedData);
   });
   

3. 检查TeamListModel的构造和属性

   • 确保所有要绑定的属性都是公共的，且有完整的get/set访问器。
   • 如果模型里有COM相关的属性，要么在构造时正确初始化对应的COM对象，要么改成延迟加载的方式，避免初始化时触发错误。

4. 调整集合初始化时机

   • 先在ViewModel构造函数里初始化空的ObservableCollection，后续再填充数据：

     public ListTeamsViewModel(ITeamService teamService)
     {
         TeamsCollection = new ObservableCollection<TeamListModel>();
         _ = LoadTeamsAsync(teamService);
     }
     
     private async Task LoadTeamsAsync(ITeamService teamService)
     {
         var data = await teamService.GetTeamsAsync();
         Application.Current.Dispatcher.Invoke(() =>
         {
             foreach(var team in data)
             {
                 TeamsCollection.Add(team);
             }
         });
     }
     

   • 或者在XAML里给CollectionView加个加载状态绑定，等集合初始化完成后再显示。

5. 清理项目缓存
   有时候是编译缓存搞的鬼，先执行Clean Solution，手动删除bin和obj文件夹，再重新编译运行，很多奇怪的COM异常都能这么解决。

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