EF Core迁移新增Message关联列触发外键约束错误的解决咨询

问题背景 #

将Notification实体中原string类型的Message字段替换为关联的Message实体，实体代码变更如下：

原实体代码 #

public class Notification
{
    [Key]
    public Guid Id { get; set; } = Guid.NewGuid();

    public string ActionType { get; set; } = string.Empty;
    public string ActionElement { get; set; } = string.Empty;
    public string ActionElementType { get; set; } = string.Empty;

    public User ForUser { get; set; } = new User();
    public User ByUser { get; set; } = new User();

    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
    public bool Seen { get; set; } = false;
    public bool Clicked { get; set; } = false;

    public Dictionary<string, string>? MessageProperties { get; set; }
    public string Message { get; set; }
} 

修改后实体代码 #

public class Notification
{
    [Key]
    public Guid Id { get; set; } = Guid.NewGuid();

    public string ActionType { get; set; } = string.Empty;
    public string ActionElement { get; set; } = string.Empty;
    public string ActionElementType { get; set; } = string.Empty;

    public User ForUser { get; set; } = new User();
    public User ByUser { get; set; } = new User();

    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
    public bool Seen { get; set; } = false;
    public bool Clicked { get; set; } = false;

    public Dictionary<string, string>? MessageProperties { get; set; }
    public Message MessageContent { get; set; }
}

public record Message
{
    [Key]
    public Guid MessageId { get; set; } = Guid.NewGuid();
    public string? MessageContent { get; init; }
    public Dictionary<string, string>? MessageContentProperties { get; init; }
}

错误信息 #

执行EF生成的迁移脚本时触发错误：

ERROR: insert or update on table "Notifications" violates foreign key constraint "FK_Notifications_Message_MessageContentMessageId"
DETAIL: Key (MessageContentMessageId)=(00000000-0000-0000-0000-000000000000) is not present in table "Message".

错误发生在执行以下SQL语句时：

ALTER TABLE "Notifications" 
ADD COLUMN "MessageContentMessageId" uuid DEFAULT uuid_nil() NOT NULL

错误原因 #

1. 迁移脚本为Notification表添加的外键列MessageContentMessageId被设置为NOT NULL，且默认值是uuid_nil()（全0的GUID）。
2. Message表中不存在主键为00000000-0000-0000-0000-000000000000的记录，违反了外键约束（外键必须引用父表中存在的主键值）。
3. 实体中MessageContent属性未标记为可空（public Message MessageContent { get; set; }），EF据此生成了NOT NULL的外键列，但现有Notification记录没有对应的Message关联数据，导致默认值无效。

解决方法 #

方法1：先允许外键列可空，迁移数据后再设为非空 #

1. 修改Notification实体，将MessageContent改为可空类型：

   public Message? MessageContent { get; set; }
   

2. 重新生成迁移脚本，此时添加的外键列会允许为空，不会触发约束错误。
3. 执行迁移后，编写数据迁移逻辑：
   • 将原Notification.Message字段的内容批量插入到Message表中，生成对应的MessageId。
   • 更新Notifications表的MessageContentMessageId列，关联对应的Message记录。
4. 数据迁移完成后，若业务需要将MessageContent设为必填，再将实体改回非可空，重新生成并执行迁移脚本。

方法2：手动调整迁移脚本顺序 #

1. 打开EF自动生成的迁移脚本，拆分步骤：
   • 先创建Message表（如果脚本中还没生成这部分，先添加创建Message表的SQL）。
   • 执行创建Message表的语句。
2. 手动执行数据迁移SQL：

   -- 插入现有Message内容到Message表
   INSERT INTO "Message" ("MessageContent")
   SELECT "Message" FROM "Notifications";
   
   -- 更新Notifications的外键列，关联对应的Message记录
   UPDATE "Notifications" n
   SET "MessageContentMessageId" = m."MessageId"
   FROM "Message" m
   WHERE n."Message" = m."MessageContent";
   

3. 修改迁移脚本中添加外键列的语句，去掉默认值并设置为NOT NULL（此时已有对应的Message记录，不会触发约束错误）：

   ALTER TABLE "Notifications" 
   ADD COLUMN "MessageContentMessageId" uuid NOT NULL;
   

4. 执行修改后的迁移脚本，最后可删除原Notification.Message字段（若不再需要）。

方法3：临时移除约束，完成数据迁移后恢复 #

1. 修改迁移脚本中的添加列语句，先允许外键列为空：

   ALTER TABLE "Notifications" 
   ADD COLUMN "MessageContentMessageId" uuid NULL;
   

2. 执行该语句，完成列添加。
3. 执行数据迁移（同方法1、2中的数据迁移步骤）。
4. 添加外键约束并设置列非空：

   ALTER TABLE "Notifications" 
   ALTER COLUMN "MessageContentMessageId" SET NOT NULL;
   ALTER TABLE "Notifications"
   ADD CONSTRAINT "FK_Notifications_Message_MessageContentMessageId"
   FOREIGN KEY ("MessageContentMessageId") REFERENCES "Message" ("MessageId");
   

内容的提问来源于stack exchange，提问作者J.Down