EF Core Sqlite迁移报错：非空外键改可空触发FOREIGN KEY约束失败

报错根本原因 #

FOREIGN KEY constraint failed报错通常由三个原因导致：

1. 当前DestinatairesPartageDocuments表中存在DocumentId值，在关联的Documents表主键中找不到对应匹配项，不符合外键约束要求
2. 自动生成的迁移文件包含多余的字段生成逻辑，你的实体类中ExamenId已经标记了[NotMapped]，但迁移文件中仍生成了新增ExamenId列的代码，可能引发额外约束冲突
3. 导航属性未同步标记为可空，导致EF Core隐式推断外键为必选

具体操作步骤 #

1. 清理无效外键数据
   先直接在数据库执行SQL查询，确认是否存在无效的DocumentId：

   SELECT * FROM DestinatairesPartageDocuments 
   WHERE DocumentId NOT IN (SELECT DocumentId FROM Documents);
   

   对查询到的无效数据，可以选择直接删除、修改为合法的DocumentId，或者改为NULL（适配你现在可空的需求）。
2. 修正导航属性配置
   把实体类中的Document导航属性同步改为可空类型，避免EF Core隐式推断约束：

   // 修改前
   public Document Document { get; set; }
   // 修改后
   public Document? Document { get; set; }
   

   同时在OnModelCreating方法中显式配置外键可空性，避免自动推断错误：

   modelBuilder.Entity<DestinatairePartageDocument>()
       .HasOne(dpd => dpd.Document)
       .WithMany() // 若Document类有对应的关联集合属性，此处填入属性名即可
       .HasForeignKey(dpd => dpd.DocumentId)
       .IsRequired(false) // 显式指定外键可空
       .OnDelete(DeleteBehavior.Restrict);
   

3. 修复迁移文件
   • 如果已经生成了UpdateDocumentNullable迁移，先执行命令移除：

     dotnet ef migrations remove
     

   • 重新生成迁移：

     dotnet ef migrations add UpdateDocumentNullable
     

   • 打开新生成的迁移文件，确认Up方法中不存在新增ExamenId列的代码，DocumentId的AlterColumn配置为nullable: true。
   • 可选操作：如果不想手动清理无效数据，可以在Up方法的AlterColumn代码前添加一行SQL执行逻辑，自动把无效DocumentId设为NULL：

     migrationBuilder.Sql("UPDATE DestinatairesPartageDocuments SET DocumentId = NULL WHERE DocumentId NOT IN (SELECT DocumentId FROM Documents)");
     

4. 执行数据库更新
   运行命令应用修改：

   dotnet ef database update
   

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