ASP.NET Core Web API集成Identity时EF Core迁移无法完成

关键解决步骤 #

• 明确指定项目参数：如果解决方案包含多个项目，迁移命令可能无法自动识别正确的项目依赖，执行命令时加上启动项目和目标项目参数：

  dotnet ef migrations add CreateIdentitySchema -Context ApplicationDbContext -s ./你的WebApi项目路径 -p ./你的WebApi项目路径
  

  -s指定承载配置的启动项目，-p指定包含ApplicationDbContext的目标项目，路径替换成你实际的项目相对路径。

• 检查DbContext注册与配置：确认Program.cs中ApplicationDbContext和Identity服务的注册正确，连接字符串配置有效：

  builder.Services.AddDbContext<ApplicationDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
  
  builder.Services.AddIdentity<ShopUser, ShopRole>()
      .AddEntityFrameworkStores<ApplicationDbContext>()
      .AddDefaultTokenProviders();
  

  同时验证appsettings.json里的DefaultConnection指向的数据库服务处于运行状态，连接字符串格式正确。

• 清理项目缓存：执行以下命令重置项目状态，避免缓存阻塞：

  dotnet clean
  dotnet restore
  

  之后手动删除项目根目录下的.vs、bin、obj文件夹，重新构建项目，再尝试迁移命令。

• 排除多DbContext冲突：因为项目有ApplicationDbContext和LibraryContext两个上下文，必须确保迁移命令明确指定目标上下文，避免EF Core自动选择错误的上下文导致加载停滞。另外检查两个上下文的连接字符串是否独立，没有配置重叠的情况。

• 验证Identity实体配置：确认自定义的ShopUser和ShopRole正确继承Identity基类，ApplicationDbContext正确继承IdentityDbContext：

  public class ShopUser : IdentityUser<int> { /* 自定义属性 */ }
  public class ShopRole : IdentityRole<int> { /* 自定义属性 */ }
  
  public class ApplicationDbContext : IdentityDbContext<ShopUser, ShopRole, int>
  {
      public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options) : base(options) { }
  }
  

• 检查SDK兼容性：执行dotnet --version确认本地安装的.NET 8 SDK是最新稳定版，若版本过旧则更新SDK，确保MSBuild版本与.NET SDK匹配。

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