如何解决Clean Architecture项目中INSERT与FOREIGN KEY约束冲突的迁移错误

问题描述 #

执行数据库迁移时出现以下错误：

The INSERT statement conflicted with the FOREIGN KEY constraint "FK_UserRoles_AspNetUsers_UserId". The conflict occurred in database "LinguaSphereDB", table "dbo.AspNetUsers", column 'Id'

尝试将GUID改为int或string后问题仍未解决。

根因分析 #

错误的核心原因是身份上下文未正确关联自定义用户实体：

• 你的IdentityContext继承了非泛型的IdentityDbContext，这会导致EF Core使用默认的IdentityUser<string>实体，映射到dbo.AspNetUsers表。
• 但你自定义的ApplicationUser被映射到了Identity.User表，同时IdentityUserRole的外键约束仍然指向默认的dbo.AspNetUsers表，而种子数据中的用户是插入到Identity.User中的，导致外键关联失败。

解决方案 #

1. 修改IdentityContext的继承关系 #

将IdentityContext改为继承泛型的IdentityDbContext<ApplicationUser>，明确指定使用自定义的用户实体：

using LinguaSphere.Core.Entities;
using LinguaSphere.Persistence.Context.Seeds.Identity;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;

namespace LinguaSphere.Persistence.Context
{
    // 改为继承IdentityDbContext<ApplicationUser>
    public class IdentityContext : IdentityDbContext<ApplicationUser>
    {
        public IdentityContext(DbContextOptions<IdentityContext> options) : base(options)
        {
            
        }

        protected override void OnModelCreating(ModelBuilder builder)
        {
            base.OnModelCreating(builder);

            #region Tables
            builder.Entity<ApplicationUser>(entity =>
            {
                entity.ToTable("User", "Identity");
            });
            builder.Entity<IdentityRole>(entity =>
            {
                entity.ToTable("Role", "Identity");
            });
            builder.Entity<IdentityUserRole<string>>(entity =>
            {
                entity.ToTable("UserRoles", "Identity");
            });

            builder.Entity<IdentityUserClaim<string>>(entity =>
            {
                entity.ToTable("UserClaims", "Identity");
            });

            builder.Entity<IdentityUserLogin<string>>(entity =>
            {
                entity.ToTable("UserLogins", "Identity");
            });

            builder.Entity<IdentityRoleClaim<string>>(entity =>
            {
                entity.ToTable("RoleClaims", "Identity");
            });

            builder.Entity<IdentityUserToken<string>>(entity =>
            {
                entity.ToTable("UserTokens", "Identity");
            });
            #endregion
            
            builder.IdentitySeed();
        }
    }
}

2. 确保ApplicationUser的继承关系 #

确认ApplicationUser类正确继承自IdentityUser<string>（如果你的主键类型是string）：

// 示例ApplicationUser代码（需确保你的项目中存在且正确）
using Microsoft.AspNetCore.Identity;

namespace LinguaSphere.Core.Entities
{
    public class ApplicationUser : IdentityUser<string>
    {
        public string FirstName { get; set; }
        public string LastName { get; set; }
        // 其他自定义属性
    }
}

3. 重新生成并执行迁移 #

• 删除旧的迁移文件（如果存在与AspNetUsers相关的历史迁移）
• 运行命令生成新的迁移：

  Add-Migration FixIdentityTableMapping
  

• 执行迁移：

  Update-Database
  

验证 #

执行迁移后，检查数据库中的表：

• 确认用户表是Identity.User而非dbo.AspNetUsers
• 确认Identity.UserRoles表的外键约束指向Identity.User的Id列

这样种子数据中的用户和角色关联就能正确插入，不会再触发外键约束冲突。

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