添加EF Core迁移遇ArgumentNullException，如何调试并获取有效信息？

一、获取更有效的报错信息 #

你已经尝试了-verbose但未得到有效信息，可以试试以下方案：

• 启用EF Core调试日志：在你的MyContext类的OnConfiguring方法中添加日志输出，捕捉迁移过程中的模型构建、数据操作细节：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.LogTo(Console.WriteLine, LogLevel.Debug);
}

• 排查种子数据：从报错栈看，问题出在级联删除时的空键，大概率是种子数据存在异常。先注释所有HasData配置，再尝试生成迁移，逐步恢复数据定位问题。

二、调试Add-Migration错误的具体方法 #

1. 手动编写调试代码 #

创建控制台项目引用你的DbContext类库，在Main方法中手动触发迁移生成，直接断点调试：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Migrations.Design;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
// 替换为你的数据库提供者和连接字符串
services.AddDbContext<MyContext>(opt => opt.UseSqlServer("YourConnectionString"));
services.AddScoped<IMigrationsScaffolder, MigrationsScaffolder>();

var provider = services.BuildServiceProvider();
var scaffolder = provider.GetRequiredService<IMigrationsScaffolder>();

// 在此处设置断点，执行后即可调试迁移生成流程
var migration = scaffolder.ScaffoldMigration("test1", "YourRootNamespace");

2. 附加进程调试 #

• 打开Visual Studio的「调试」→「附加到进程」，找到dotnet.exe（使用.NET CLI时）或ef.exe（使用PMC时）进程并附加。
• 执行add-migration test1 -context mycontext命令，触发断点后即可逐步排查调用栈中的问题。

3. 逐步排查模型配置 #

• 检查实体类的主键/外键：确保主键为非空类型，外键关联的实体主键存在且配置正确。
• 验证OnModelCreating配置：检查HasOne/WithMany等关系配置是否有误，是否存在循环引用或属性忽略错误。
• 回退最近修改：如果是新增/修改实体后出现问题，逐步移除修改，每次尝试生成迁移，定位错误来源。

三、针对当前报错的定向排查 #

从报错System.ArgumentNullException: Value cannot be null. (Parameter 'key')及调用链分析，问题出在EF Core对比模型差异、处理级联删除时访问了空键，重点检查：

• 种子数据中是否存在主键为null的实体，或外键指向不存在的实体。
• 实体主键是否被错误设置为可空类型（如int?而非int）。
• 最近的模型修改是否导致与现有迁移历史不兼容。

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