基于TPH实现Reminders API：多类型提醒单表存储方案求助

问题背景 #

当前开发Reminders API，核心实体包含Frequency（一次性/周期性）和Type（如预约）两个属性，现有抽象基类及实现类如下：

抽象基类 #

public abstract class ReminderDao
{
    public int Id { get; set; }

    public abstract ReminderFrequency Frequency { get; }
    public abstract ReminderType Type { get; }

    public string Title { get; set; }
    public string Description { get; set; }
}

public abstract class OneTimeReminderDao : ReminderDao
{
    public override ReminderFrequency Frequency => ReminderFrequency.OneTime;

    // OneTime专属字段
    public DateTimeOffset Date { get; set; }
}

public abstract class RecurringReminderDao : ReminderDao
{
    public override ReminderFrequency Frequency => ReminderFrequency.Recurring;

    // Recurring专属字段
    public DateTimeOffset StartDate { get; set; }
    public TimeSpan Interval { get; set; }
}

实现类 #

public sealed class AppointmentOneTimeReminderDao : OneTimeReminderDao
{
    public override ReminderType Type => ReminderType.Appointment;
}

public sealed class AppointmentRecurringReminderDao : RecurringReminderDao
{
    public override ReminderType Type => ReminderType.Appointment;
}

需求：通过**TPH（表每层次）**继承模式，将所有类型的提醒存入同一个Reminders表。

解决方案 #

1. 调整实体类适配EF Core映射 #

为了让EF Core识别继承关系中的固定属性值，微调基类属性定义：

• 将基类ReminderDao中的抽象属性改为虚拟属性，子类仍保留固定返回值的重写逻辑，既保证业务一致性，也方便EF映射
• 若需将Frequency/Type作为数据库字段直接查询，可保留属性的枚举类型，后续通过配置转换为存储列

调整后的基类示例：

public abstract class ReminderDao
{
    public int Id { get; set; }

    // 改为虚拟属性，子类重写返回固定值
    public virtual ReminderFrequency Frequency { get; }
    public virtual ReminderType Type { get; }

    public string Title { get; set; }
    public string Description { get; set; }
}

2. 配置EF Core TPH继承映射 #

在DbContext的OnModelCreating方法中，通过Fluent API定义单表存储规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置基类映射到Reminders表
    var reminderEntity = modelBuilder.Entity<ReminderDao>()
        .ToTable("Reminders");

    // 配置鉴别器列：用字符串标识不同子类，也可选择枚举类型
    reminderEntity.HasDiscriminator<string>("Discriminator")
        .HasValue<AppointmentOneTimeReminderDao>("Appointment_OneTime")
        .HasValue<AppointmentRecurringReminderDao>("Appointment_Recurring");

    // 配置一次性提醒专属字段：仅OneTime类型记录需填充，允许为null
    modelBuilder.Entity<OneTimeReminderDao>()
        .Property(r => r.Date)
        .IsRequired(false);

    // 配置周期性提醒专属字段：仅Recurring类型记录需填充，允许为null
    modelBuilder.Entity<RecurringReminderDao>()
        .Property(r => r.StartDate)
        .IsRequired(false);
    modelBuilder.Entity<RecurringReminderDao>()
        .Property(r => r.Interval)
        .IsRequired(false);

    // 可选：将Type属性映射为数据库字段，方便直接筛选查询
    reminderEntity.Property(r => r.Type)
        .HasConversion<string>()
        .IsRequired();
}

3. 数据库表结构说明 #

最终生成的Reminders表包含以下核心字段：

• Id：主键（int）
• Discriminator：鉴别器列（string），EF自动维护，用于区分不同子类实例
• Type：提醒类型列（字符串/整数，可选配置）
• Title/Description：基类公共字段
• Date：一次性提醒专属日期（可空DateTimeOffset）
• StartDate/Interval：周期性提醒专属字段（可空DateTimeOffset、可空TimeSpan）

4. 数据操作示例 #

插入数据

// 添加一次性预约提醒
context.Reminders.Add(new AppointmentOneTimeReminderDao
{
    Title = "门诊预约",
    Description = "明天上午9点内科门诊",
    Date = new DateTimeOffset(2024, 6, 1, 9, 0, 0, TimeSpan.Zero)
});

// 添加周期性预约提醒
context.Reminders.Add(new AppointmentRecurringReminderDao
{
    Title = "每周复诊",
    Description = "每周一上午10点复诊",
    StartDate = new DateTimeOffset(2024, 6, 3, 10, 0, 0, TimeSpan.Zero),
    Interval = TimeSpan.FromDays(7)
});

context.SaveChanges();

查询数据

// 查询所有预约类型的提醒
var appointmentReminders = context.Reminders
    .OfType<AppointmentOneTimeReminderDao>()
    .Union(context.Reminders.OfType<AppointmentRecurringReminderDao>())
    .ToList();

// 查询所有一次性提醒
var oneTimeReminders = context.Reminders.OfType<OneTimeReminderDao>().ToList();

注意事项 #

• 鉴别器列的值由EF Core自动赋值，无需手动干预
• 专属字段需配置为可空，避免数据库约束冲突；业务逻辑层需校验对应类型的字段必填性
• 后续新增提醒类型（如TaskOneTimeReminderDao），只需添加子类并在Fluent API中新增HasValue配置即可

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