如何使用EF Core向实体的SubTasks集合属性插入子项

前置配置（必做，否则关联关系会异常） #

你定义的Do实体是自引用一对多结构，即单个父任务可以关联多个子任务，EF Core默认约定无法完美处理这类关联，需要先完成关系配置，否则可能出现外键关联错误、循环级联删除报错等问题。
推荐先给实体补充父任务导航属性与外键字段（开发中可维护性更高），修改后的实体代码：

public class Do
{
    [Key]
    public int Id { get; set; }
    [Required]
    public string Title { get; set; }
    [Required]
    public string Description { get; set; }
    public string Executors { get; set; }
    public DoStatus Status { get; set; }
    public DateTime Created { get; set; } = DateTime.Now;
    [Required]
    public int Plan { get; set; }
    public int Fact { get; set; }
    public DateTime? Finished { get; set; }

    // 父任务外键，可空表示顶级任务无父级
    public int? ParentDoId { get; set; }
    // 父任务导航属性
    public virtual Do ParentDo { get; set; }
    
    public virtual ICollection<Do> SubTasks { get; set; } = new List<Do>();
}

随后在自定义DbContext的OnModelCreating方法中添加关系配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Do>()
        .HasMany(d => d.SubTasks)
        .WithOne(d => d.ParentDo)
        .HasForeignKey(d => d.ParentDoId)
        // 禁用级联删除，避免自引用结构触发循环级联报错
        .OnDelete(DeleteBehavior.Restrict);
}

配置完成后执行EF Core迁移命令生成表结构、更新数据库即可。

如果你不想修改实体类，也可以直接通过Fluent API配置影子外键，但后续操作子项时需要手动给影子属性赋值，可读性差，不推荐生产环境使用。

两种添加子项的实现方式 #

根据业务场景选对应写法即可：

方式1：已查询到追踪态父任务，直接操作集合 #

如果已经从数据库查询到父任务实体（被当前DbContext追踪），直接往SubTasks集合添加新子项后保存即可，EF Core会自动维护外键关联：

using var dbContext = new YourAppDbContext();
// 查询需要添加子项的父任务，无需强制Include SubTasks集合，EF Core可自动识别关联
var parentTask = dbContext.Dos.FirstOrDefault(d => d.Id == 目标父任务ID);
if (parentTask == null)
{
    // 自行处理父任务不存在的业务逻辑
    return;
}

// 初始化子任务对象
var subTask = new Do
{
    Title = "子任务标题",
    Description = "子任务详情",
    Plan = 2,
    Status = DoStatus.NotStarted
    // 无需手动赋值ParentDoId，EF Core保存时会自动关联
};

// 加入父任务的子项集合
parentTask.SubTasks.Add(subTask);

// 持久化到数据库
dbContext.SaveChanges();

注意：如果查询父任务时使用了AsNoTracking，父任务不会被上下文追踪，此时直接往SubTasks加对象不会被EF Core识别，需要改用方式2实现。

方式2：已知父任务ID，直接新增子项（性能更优） #

如果不需要操作父任务的其他属性，仅已知父任务ID，可以直接新建子项给外键赋值，跳过查询父任务的步骤，减少一次数据库交互，适合批量新增子项的场景：

using var dbContext = new YourAppDbContext();
var subTask = new Do
{
    Title = "子任务标题",
    Description = "子任务详情",
    Plan = 2,
    Status = DoStatus.NotStarted,
    ParentDoId = 已知的父任务ID // 直接绑定外键
};

dbContext.Dos.Add(subTask);
dbContext.SaveChanges();

常见问题说明 #

• 子任务本身也可以继续添加自己的SubTasks子项，逻辑和上述步骤完全一致，递归处理即可实现多层级任务结构
• 不要手动给新子项赋值主键Id，EF Core会按配置的主键生成规则自动生成
• 如果出现循环级联删除报错，检查是否忘记给自引用关系设置OnDelete(DeleteBehavior.Restrict)
• 懒加载开启的情况下，访问父任务的SubTasks属性会自动查询所有子项，不需要手动Include

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