.NET 6 Code First模式下如何用预哈希密码初始化默认用户？

核心思路 #

用ASP.NET Core自带的PasswordHasher<TUser>类处理密码哈希，在种子数据初始化时直接使用哈希值（或从环境变量读取预哈希的密码）创建用户，彻底避免明文密码暴露。

实现步骤 #

1. 编写数据库初始化类

新建负责种子数据初始化的类，注入数据库上下文和用户管理器，用PasswordHasher生成或读取哈希密码：

using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;

public static class DbInitializer
{
    public static async Task InitializeAsync(IServiceProvider serviceProvider)
    {
        using var scope = serviceProvider.CreateScope();
        var context = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
        var userManager = scope.ServiceProvider.GetRequiredService<UserManager<IdentityUser>>();

        // 确保数据库已创建
        await context.Database.EnsureCreatedAsync();

        // 检查默认用户是否已存在，避免重复创建
        var defaultUser = await userManager.FindByEmailAsync("default@example.com");
        if (defaultUser == null)
        {
            // 方式1：代码内生成哈希密码（适合固定默认密码的场景）
            var passwordHasher = new PasswordHasher<IdentityUser>();
            var hashedPassword = passwordHasher.HashPassword(null, "YourSecureDefaultPass123!");

            // 方式2：从环境变量读取预哈希的密码（推荐，更安全）
            // var hashedPassword = Environment.GetEnvironmentVariable("DEFAULT_USER_HASHED_PWD") ?? throw new InvalidOperationException("未配置默认用户哈希密码");

            var user = new IdentityUser
            {
                UserName = "default_user",
                Email = "default@example.com",
                EmailConfirmed = true,
                PasswordHash = hashedPassword // 直接赋值哈希值
            };

            await userManager.CreateAsync(user);
        }
    }
}

2. 在Program.cs中触发初始化

在.NET 6的Program.cs里，添加初始化逻辑，确保应用启动时执行种子数据：

var builder = WebApplication.CreateBuilder(args);

// 注册DbContext和Identity服务
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();

// 其他服务注册...

var app = builder.Build();

// 执行数据库初始化
await DbInitializer.InitializeAsync(app.Services);

// 中间件配置...

app.Run();

3. 预生成哈希密码（用于环境变量场景）

如果要把哈希密码存到环境变量，先通过临时程序生成哈希值：

using Microsoft.AspNetCore.Identity;

var passwordHasher = new PasswordHasher<object>();
var hashedPassword = passwordHasher.HashPassword(null, "YourSecureDefaultPass123!");
Console.WriteLine(hashedPassword);

运行后复制输出的哈希字符串，设置到环境变量DEFAULT_USER_HASHED_PWD即可。

注意事项 #

• 绝对不要在代码中硬编码明文密码，优先用环境变量传递预哈希值。
• PasswordHasher生成的哈希自带盐值，同一明文每次哈希结果不同，但验证时能正确匹配。
• 初始化逻辑已通过FindByEmailAsync检查用户是否存在，避免重复创建。

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