Xamarin.Forms SQLite CodeFirst：关联对象列表元素添加问题咨询

我之前在Xamarin.Forms用SQLite CodeFirst处理一对多关联的时候也踩过一模一样的坑，咱们从几个核心点排查解决：

1. 确认数据模型的关联配置（关键！） #

原生的SQLite-net库本身不支持自动处理关联关系，你需要使用SQLiteNetExtensions扩展库来实现一对多的关联操作，同时要给模型加上正确的属性标记：

主对象模型示例 #

using SQLite;
using SQLiteNetExtensions.Attributes;

public class MainEntity
{
    [PrimaryKey]
    public Guid Id { get; set; } = Guid.NewGuid();
    public DateTime LastModified { get; set; } = DateTime.Now;

    // 标记一对多关联，设置级联操作（自动同步子对象的增删改）
    [OneToMany(CascadeOperations = CascadeOperation.All)]
    public List<ChildEntity> ChildItems { get; set; } = new List<ChildEntity>();
}

子对象模型示例 #

using SQLite;
using SQLiteNetExtensions.Attributes;

public class ChildEntity
{
    [PrimaryKey, AutoIncrement]
    public int Id { get; set; }
    public string Content { get; set; }

    // 标记外键，关联主对象的Id字段
    [ForeignKey(typeof(MainEntity))]
    public Guid MainEntityId { get; set; }
}

2. 正确的子元素添加流程 #

光有模型配置还不够，添加子元素时要遵循SQLiteNetExtensions的操作规范，不能直接修改主对象的列表就完事：

方法一：使用级联更新自动插入子对象 #

// 初始化数据库连接（确保用SQLiteNetExtensions的方法）
var db = new SQLiteConnection(_dbPath);
db.CreateTable<MainEntity>();
db.CreateTable<ChildEntity>();

// 创建并插入主对象
var mainObj = new MainEntity();
db.Insert(mainObj);

// 创建子对象并关联主对象
var child = new ChildEntity 
{ 
    Content = "测试子元素",
    MainEntityId = mainObj.Id // 必须手动设置外键！
};
mainObj.ChildItems.Add(child);

// 使用UpdateWithChildrenAsync同步主对象和子对象到数据库
db.UpdateWithChildren(mainObj);

方法二：手动插入子对象后重新加载关联 #

如果不需要级联操作，也可以单独插入子对象，再重新加载主对象的关联列表：

// 插入主对象
var mainObj = new MainEntity();
db.Insert(mainObj);

// 创建并插入子对象
var child = new ChildEntity 
{ 
    Content = "测试子元素",
    MainEntityId = mainObj.Id
};
db.Insert(child);

// 重新加载主对象的子列表
var updatedMainObj = db.GetWithChildren<MainEntity>(mainObj.Id);
// 此时updatedMainObj.ChildItems就包含刚添加的子元素了

3. 常见坑点排查 #

• 忘记安装SQLiteNetExtensions：如果还没装，赶紧通过NuGet安装SQLiteNetExtensions和SQLiteNetExtensions.Async（异步场景用），原生SQLite-net完全不支持关联操作。
• 外键未赋值：子对象必须明确设置指向主对象的外键字段，否则数据库不知道该关联哪个主对象。
• 未创建子表：CodeFirst模式下，要确保同时调用CreateTable<ChildEntity>()，否则子表不存在，插入会报错。
• 调试时查看SQL日志：可以开启SQLite的日志功能，检查执行的SQL语句是否正确：

var db = new SQLiteConnection(_dbPath);
db.Trace = true; // 开启日志，控制台会输出执行的SQL

按照上面的步骤调整后，应该就能正常添加子元素到主对象的关联列表里了。

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