Xamarin.Forms MVVM模式下SQLite加载Picker数据遇自定义类型无效问题

解决方案 #

你遇到的报错核心原因是Xamarin常用的SQLite-net ORM仅支持基础值类型、字符串等可直接映射到SQLite字段的类型，自定义类、泛型集合默认无法映射，所以会触发建表异常。下面提供三种可行方案：

方案1：添加[Ignore]标记快速解决（最快适配现有代码） #

给不需要持久化到数据库的自定义类型、集合类型属性加[SQLite.Ignore]特性，ORM会自动跳过这些字段，不会尝试为其创建数据库列，修改后的ProductModel代码如下：

public class ProductModel : INotifyPropertyChanged
{
    // 其他属性、构造函数、事件逻辑保持不变

    [PrimaryKey, AutoIncrement]
    public int ProductId { get; set; }

    // 标记忽略，SQLite不会尝试存储该集合
    [Ignore]
    public ObservableCollection<Quantity> ListQuantites
    {
        get => _ListQuantites;
        set
        {
            _ListQuantites = value;
            OnPropertyChanged();
        }
    }

    // 标记忽略，仅存储选中数量的唯一标识即可
    [Ignore]
    public Quantity SelectedQuantity
    {
        get => _selectedQuantity;
        set
        {
            if (value != null)
            {
                _selectedQuantity = value;
                // 同步存储选中数量的Key到可持久化字段
                SelectedQuantityKey = value.Key;
                OnPropertyChanged();
            }
        }
    }

    // 新增基础类型字段，用于持久化选中的数量
    public int SelectedQuantityKey { get; set; }
}

注意：你的Picker可选数量是公共固定数据源，完全不需要每个Product实例单独存储一份ListQuantites，直接绑定ViewModel层的全局List_Quantites属性即可，还能减少内存冗余。调整后的XAML绑定代码如下：

<Picker Grid.Column="3" Grid.Row="0" Title="     " VerticalOptions="Center" 
        x:Name="productPicker" VerticalTextAlignment="Center" HorizontalOptions="EndAndExpand"
        <!-- ItemsSource绑定到ViewModel层的全局数量集合，不要绑定Product的属性 -->
        ItemsSource="{Binding BindingContext.List_Quantites, Source={x:Reference productPicker}}"
        ItemDisplayBinding="{Binding Value}" 
        SelectedIndexChanged="QuantityChanged" 
        SelectedItem ="{Binding SelectedQuantity}"/>

方案2：序列化自定义类型存储（适配需要个性化配置商品可选数量的场景） #

如果不同商品需要配置不同的可选数量列表，可以把集合序列化为JSON字符串存到数据库，取数时再反序列化，示例代码：

public class ProductModel : INotifyPropertyChanged
{
    // 其他属性不变
    // 用于存储序列化后的数量列表
    public string ListQuantitesJson { get; set; }

    [Ignore]
    public ObservableCollection<Quantity> ListQuantites
    {
        get 
        {
            if(string.IsNullOrEmpty(ListQuantitesJson)) 
                return PickerService.GetQuantitiesForProductPage();
            return System.Text.Json.JsonSerializer.Deserialize<ObservableCollection<Quantity>>(ListQuantitesJson);
        }
        set 
        {
            ListQuantitesJson = System.Text.Json.JsonSerializer.Serialize(value);
            OnPropertyChanged();
        }
    }
}

方案3：拆分数据层和UI层模型（最规范的架构方案） #

如果需要长期维护项目，建议拆分两类模型：

• 数据库实体类：仅包含需要持久化的基础类型属性，无任何UI绑定逻辑
• UI绑定模型：封装数据库实体，添加绑定需要的集合、自定义类型属性和通知逻辑
  该方案可以彻底解耦数据持久化和UI层逻辑，避免后续迭代再出现类似映射冲突。

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