如何将默认使用SQL Server的Blazor独立账户认证项目切换为MongoDB

我完全理解你想统一技术栈、避免混用SQL Server和MongoDB的需求——这确实能让后续维护更省心。下面是一套经过验证的实现步骤，帮你把Blazor认证的底层存储彻底换成MongoDB：

1. 清理SQL Server相关依赖与配置 #

首先把项目里和SQL Server/EF Core Identity相关的内容移除：

• 卸载NuGet包：Microsoft.AspNetCore.Identity.EntityFrameworkCore、Microsoft.EntityFrameworkCore.SqlServer以及Microsoft.EntityFrameworkCore.Tools（如果之前用来做迁移的话）
• 删除原来的ApplicationDbContext类（它继承自IdentityDbContext，依赖EF Core）
• 在appsettings.json里替换连接串：把原来的DefaultConnection换成MongoDB的连接配置，比如：

  "ConnectionStrings": {
    "MongoDBConnection": "mongodb://localhost:27017"
  },
  "MongoDBSettings": {
    "DatabaseName": "BlazorAuthDB"
  }
  

2. 添加MongoDB Identity支持包 #

安装专门适配ASP.NET Core Identity的MongoDB存储包，社区里最常用的是MongoDB.AspNetCore.Identity：

Install-Package MongoDB.AspNetCore.Identity
# 或者用.NET CLI
dotnet add package MongoDB.AspNetCore.Identity

3. 定义自定义Identity实体（可选但推荐） #

MongoDB用文档模型，你可以继承包提供的基类来扩展自己的用户/角色字段：

using MongoDB.AspNetCore.Identity;

// 自定义用户实体，继承MongoUser
public class ApplicationUser : MongoUser
{
    // 这里可以添加你的自定义字段，比如真实姓名、头像URL等
    public string FullName { get; set; } = string.Empty;
}

// 自定义角色实体（如果需要角色管理的话）
public class ApplicationRole : MongoRole
{
    // 自定义角色属性，比如角色描述
    public string Description { get; set; } = string.Empty;
}

4. 配置Identity使用MongoDB存储 #

在Program.cs里，替换原来的EF Core相关配置，改成注册MongoDB Identity服务：

var builder = WebApplication.CreateBuilder(args);

// 读取MongoDB配置
var mongoConnString = builder.Configuration.GetConnectionString("MongoDBConnection");
var mongoDbName = builder.Configuration["MongoDBSettings:DatabaseName"];

// 注册MongoDB Identity服务
builder.Services.AddIdentity<ApplicationUser, ApplicationRole>(options =>
    {
        // 这里可以配置Identity的规则，比如密码复杂度、锁定策略等
        options.Password.RequireDigit = true;
        options.Password.RequireLowercase = true;
    })
    .AddMongoDbStores<ApplicationUser, ApplicationRole, Guid>(mongoConnString, mongoDbName)
    .AddDefaultTokenProviders();

// 其他Blazor相关配置（比如AddRazorPages、AddServerSideBlazor等）保持不变
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
// ...

var app = builder.Build();

// 中间件配置保持不变，认证授权中间件要放在路由之前
app.UseAuthentication();
app.UseAuthorization();

// ... 其他中间件和端点配置

5. 调整认证相关页面（如果需要） #

如果你用了Blazor的默认认证UI（比如LoginDisplay、Register页面），大部分逻辑不用改——因为Identity的API层和UI交互逻辑和之前一致，只是底层存储换了。如果有自定义的用户数据展示，只需要调整对应的实体引用即可（比如把原来的IdentityUser换成ApplicationUser）。

6. 测试与验证 #

启动项目后，尝试注册新用户、登录，然后去MongoDB客户端（比如Compass）查看BlazorAuthDB数据库里的users和roles集合，确认用户数据已经正确存储到MongoDB中。

额外注意事项 #

• 索引优化：MongoDB Identity会自动为用户名、邮箱等字段创建唯一索引，但你可以根据自己的查询需求添加额外索引
• 数据迁移：如果之前有SQL Server的用户数据，需要写脚本把SQL的关系型数据转换成MongoDB的文档结构（比如把AspNetUsers表的每条记录转成ApplicationUser文档）
• 兼容性：这套方案兼容Blazor Server和Blazor WebAssembly（WASM）——如果是WASM，只需要在后端API项目里按上述配置，前端的认证逻辑无需修改

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