MAUI添加第二个集合项触发IllegalStateException问题求助

异常核心原因 #

这个Java.Lang.IllegalStateException异常本质是视图实例被重复添加到多个父容器，在MAUI中通常由以下场景触发：

• ItemTemplateSelector错误地返回了同一个已存在的View实例，而非通过DataTemplate创建新实例
• 模板选择器实现逻辑存在视图复用问题，导致第二次添加元素时，旧视图仍绑定在之前的父容器上
• 绑定的集合未正确实现INotifyCollectionChanged（比如用普通List而非ObservableCollection），导致CollectionView更新时视图复用逻辑混乱

解决方案 #

1. 修正ItemTemplateSelector实现 #

必须确保模板选择器返回DataTemplate实例而非直接返回View对象，模板需定义在XAML资源中或通过工厂方法动态创建新视图：

错误示例（直接返回View实例）

public class BadTemplateSelector : DataTemplateSelector
{
    protected override DataTemplate OnSelectTemplate(object item, BindableObject container)
    {
        // 错误：直接返回View，会导致重复使用同一个实例
        return new Label { Text = item.ToString() } as DataTemplate;
    }
}

正确实现（返回DataTemplate）

先在XAML资源中定义模板：

<ContentPage.Resources>
    <DataTemplate x:Key="TextItemTemplate">
        <Label Text="{Binding Content}" Margin="10" />
    </DataTemplate>
    <DataTemplate x:Key="CollectionItemTemplate">
        <CollectionView ItemsSource="{Binding SubItems}">
            <CollectionView.ItemTemplateSelector>
                <local:SubItemTemplateSelector 
                    SubTextTemplate="{StaticResource TextItemTemplate}"
                    SubButtonTemplate="{StaticResource ButtonItemTemplate}" />
            </CollectionView.ItemTemplateSelector>
        </CollectionView>
    </DataTemplate>
    <local:MainItemTemplateSelector 
        TextTemplate="{StaticResource TextItemTemplate}"
        CollectionTemplate="{StaticResource CollectionItemTemplate}"
        x:Key="MainTemplateSelector" />
</ContentPage.Resources>

模板选择器代码：

public class MainItemTemplateSelector : DataTemplateSelector
{
    public DataTemplate TextTemplate { get; set; }
    public DataTemplate CollectionTemplate { get; set; }

    protected override DataTemplate OnSelectTemplate(object item, BindableObject container)
    {
        return item is TextItem ? TextTemplate : CollectionTemplate;
    }
}

2. 使用ObservableCollection作为绑定集合 #

确保ViewModel中的集合实现INotifyCollectionChanged，MAUI推荐直接用ObservableCollection<T>：

public class MainViewModel : INotifyPropertyChanged
{
    public ObservableCollection<object> MainItems { get; } = new();

    public void AddNewItem()
    {
        // 必须在UI线程更新集合，避免跨线程问题
        MainThread.BeginInvokeOnMainThread(() =>
        {
            MainItems.Add(new TextItem { Content = $"New Item {MainItems.Count + 1}" });
        });
    }

    // 实现INotifyPropertyChanged接口（可使用CommunityToolkit.Mvvm简化）
    public event PropertyChangedEventHandler? PropertyChanged;
    protected void OnPropertyChanged([CallerMemberName] string? propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

3. 避免手动复用视图实例 #

绝对不要在代码中手动保存View实例并重复返回，所有视图实例由DataTemplate的工厂方法自动创建和管理。

4. 嵌套CollectionView的额外注意事项 #

内层CollectionView的模板选择器必须遵循同样的规则，确保每个子项的视图都是新实例；同时内层CollectionView的ItemsSource必须绑定到子数据对象的独立集合，不能共享同一个集合实例。

验证步骤 #

1. 检查所有ItemTemplateSelector是否只返回DataTemplate，而非直接返回View
2. 确认绑定的集合都是ObservableCollection
3. 测试添加第二个元素时，是否每个元素对应的视图都是全新创建的
4. 确保没有手动操作View的父容器（比如代码中调用AddView或类似方法）

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