.NET 7数据库优先模式下创建ASP.NET Identity表及架构变更咨询

查看图片了解项目结构。

一、ASP.NET Identity表的创建与集成（数据库优先模式） #

不需要手动从零构建Identity表，推荐用以下规范流程：

1. 通过官方SQL脚本生成Identity表结构
   .NET 7对应的ASP.NET Identity有官方预定义的SQL脚本，直接执行到现有数据库即可：

   • 脚本包含AspNetUsers、AspNetRoles、AspNetUserRoles等所有核心Identity表的创建语句，以及对应的索引、约束和外键关系，完全符合Identity框架的要求。
   • 你可以临时创建一个代码优先的Identity项目，执行dotnet ef migrations script生成对应脚本，或者直接使用EF Core仓库中对应.NET 7版本的Identity脚本，执行到你的现有数据库。

2. Scaffold Identity实体并集成到DbContext
   执行Scaffold命令生成Identity表对应的实体类，再将其与Identity框架集成：

   Scaffold-DbContext "YourConnectionString" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Entities -Context AppDbContext -Tables AspNetUsers,AspNetRoles,AspNetUserRoles,AspNetUserClaims,AspNetUserLogins,AspNetUserTokens,AspNetRoleClaims
   

   生成后做两处关键调整：

   • 修改生成的实体类，让AspNetUsers继承IdentityUser<string>，AspNetRoles继承IdentityRole<string>，保留scaffold生成的自定义属性：

     public partial class AspNetUsers : IdentityUser<string>
     {
         // 保留数据库中用户表的额外字段
         public string? CustomField { get; set; }
     }
     

   • 修改DbContext，让它继承IdentityDbContext<AspNetUsers, AspNetRoles, string>，并在OnModelCreating中先调用Identity的基础配置：

     public partial class AppDbContext : IdentityDbContext<AspNetUsers, AspNetRoles, string>
     {
         public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
     
         // 保留scaffold生成的DbSet定义
         public virtual DbSet<YourExistingEntity> YourExistingEntities { get; set; }
     
         protected override void OnModelCreating(ModelBuilder modelBuilder)
         {
             // 先执行Identity的模型配置
             base.OnModelCreating(modelBuilder);
             // 再执行scaffold生成的数据库实体配置
             modelBuilder.Entity<AspNetUsers>(entity =>
             {
                 // 保留生成的配置代码
             });
             // 其他实体的配置代码...
         }
     }
     

   这样Identity框架就能直接使用数据库中的这些表，无需手动维护结构。

二、从代码优先切换到数据库优先的核心变更 #

在Clean Architecture架构下，主要调整基础设施层和少量应用层代码：

1. 移除代码优先相关组件

   • 删除基础设施层中的Migrations文件夹及所有迁移类。
   • 修改Program.cs中DbContext的配置，移除迁移集相关的配置，比如将options.UseSqlServer(connStr, b => b.MigrationsAssembly("YourInfrastructureProject"))改为仅配置连接字符串。

2. 替换实体与DbContext

   • 用Scaffold命令生成的数据库实体，替换原来代码优先手动编写的领域实体（如果需要保持领域层的抽象，可以在领域层定义接口，让生成的实体实现这些接口）。
   • 替换原有的自定义DbContext为scaffold生成的DbContext，并按上述Identity集成要求调整继承关系。

3. 调整仓储与数据访问逻辑

   • 确保仓储接口的泛型参数适配生成的实体类型，比如将IRepository<DomainUser>改为IRepository<AspNetUsers>，或者封装一层适配类来衔接领域层和数据层。
   • 移除依赖EF Core迁移的种子数据逻辑，改为直接在数据库中维护初始数据，或者编写独立的SQL脚本执行初始化。

4. 验证核心功能

   • 测试DbContext是否能正常连接现有数据库，读写所有表数据。
   • 验证Identity的登录、角色分配、权限控制等功能是否正常工作，确认框架能正确操作生成的Identity表。

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