EF Core迁移时如何为现有用户生成并插入加密密码？

针对你遇到的EF Core中明文密码替换为加密列的问题，以下是几个实用的解决方案，按推荐优先级排序：

方案一：分阶段部署 + 应用启动时批量处理 #

这是最稳妥、通用性最强的方案，完全复用代码中的加密逻辑，且迁移脚本可跨环境复用：

• 步骤1：第一版迁移
  新增EncryptedPassword列，设置为允许为空，发布这版迁移和应用。
• 步骤2：一次性批量加密
  在应用启动逻辑（比如Program.cs的初始化段）添加一段仅执行一次的代码：

  // 示例：用依赖注入获取DbContext和加密服务
  using var scope = app.Services.CreateScope();
  var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
  var encryptionService = scope.ServiceProvider.GetRequiredService<IEncryptionService>();
  
  // 检查是否已完成加密迁移（避免重复执行）
  var hasMigrated = await dbContext.Settings.AnyAsync(s => s.Key == "PasswordEncryptionCompleted");
  if (!hasMigrated)
  {
      var usersToEncrypt = await dbContext.Users.Where(u => u.EncryptedPassword == null).ToListAsync();
      foreach (var user in usersToEncrypt)
      {
          user.EncryptedPassword = encryptionService.Encrypt(user.Password);
      }
      await dbContext.SaveChangesAsync();
  
      // 标记任务完成
      await dbContext.Settings.AddAsync(new Setting { Key = "PasswordEncryptionCompleted", Value = "True" });
      await dbContext.SaveChangesAsync();
  }
  

  注意：需要加个标记（比如数据库配置表、缓存键）确保这段代码只执行一次，多实例部署时建议用分布式锁防止冲突。
• 步骤3：第二版迁移
  等所有用户的加密密码更新完成后，发布第二版迁移：将原明文密码列设为不可空（若需保留）或直接删除，同时把EncryptedPassword设为不可空。
• 优点：完全复用代码中的加密逻辑，无迁移脚本兼容性问题，适合所有环境；风险低，可随时回滚。
• 缺点：需要分两次部署，生产环境需确保第一版部署后所有用户加密完成再推进第二版。

方案二：自定义迁移操作，嵌入加密逻辑 #

如果想一次性完成迁移，可在迁移类中直接用ADO.NET执行加密更新，避免依赖EF上下文生成不可复用的脚本：

• 步骤：
  在自动生成的迁移类中，添加自定义方法处理加密逻辑：

  protected override void Up(MigrationBuilder migrationBuilder)
  {
      // 新增EncryptedPassword列
      migrationBuilder.AddColumn<string>(
          name: "EncryptedPassword",
          table: "Users",
          type: "nvarchar(max)",
          nullable: true);
  
      // 调用自定义加密更新方法
      UpdateEncryptedPasswords();
  }
  
  private void UpdateEncryptedPasswords()
  {
      // 读取连接字符串（适配不同环境，比如从appsettings或环境变量）
      var config = new ConfigurationBuilder()
          .SetBasePath(Directory.GetCurrentDirectory())
          .AddJsonFile("appsettings.json")
          .AddEnvironmentVariables()
          .Build();
      var connectionString = config.GetConnectionString("DefaultConnection");
  
      using var conn = new SqlConnection(connectionString);
      conn.Open();
  
      // 查询需加密的用户
      var queryCmd = conn.CreateCommand();
      queryCmd.CommandText = "SELECT Id, Password FROM Users WHERE EncryptedPassword IS NULL";
      using var reader = queryCmd.ExecuteReader();
      while (reader.Read())
      {
          var userId = reader.GetGuid(0);
          var plainPassword = reader.GetString(1);
          // 调用你的加密逻辑
          var encryptedPassword = YourEncryptionUtility.Encrypt(plainPassword);
  
          // 更新加密密码
          var updateCmd = conn.CreateCommand();
          updateCmd.CommandText = "UPDATE Users SET EncryptedPassword = @EncryptedPassword WHERE Id = @Id";
          updateCmd.Parameters.AddWithValue("@EncryptedPassword", encryptedPassword);
          updateCmd.Parameters.AddWithValue("@Id", userId);
          updateCmd.ExecuteNonQuery();
      }
  }
  
  protected override void Down(MigrationBuilder migrationBuilder)
  {
      migrationBuilder.DropColumn(
          name: "EncryptedPassword",
          table: "Users");
  }
  

• 优点：一次性完成迁移，无需分阶段部署；加密逻辑复用代码，迁移脚本可跨环境执行（只要连接字符串配置正确）。
• 缺点：迁移类中引入ADO.NET代码，略有耦合；需确保加密工具类在迁移环境中可正常调用（比如依赖的加密库已安装）。

方案三：SQL自定义函数（仅适用于简单加密逻辑） #

如果你的加密逻辑可通过SQL实现（比如SHA256哈希），可直接在迁移脚本中创建SQL函数并执行更新：

• 步骤：

  protected override void Up(MigrationBuilder migrationBuilder)
  {
      migrationBuilder.AddColumn<string>(
          name: "EncryptedPassword",
          table: "Users",
          type: "nvarchar(max)",
          nullable: true);
  
      // 创建SQL加密函数
      migrationBuilder.Sql(@"
          CREATE FUNCTION dbo.EncryptPassword(@plainPassword NVARCHAR(MAX))
          RETURNS NVARCHAR(MAX)
          AS
          BEGIN
              -- 示例：SHA256哈希，根据你的加密逻辑调整
              RETURN CONVERT(NVARCHAR(MAX), HASHBYTES('SHA2_256', @plainPassword), 2)
          END
      ");
  
      // 批量更新加密密码
      migrationBuilder.Sql(@"
          UPDATE Users SET EncryptedPassword = dbo.EncryptPassword(Password)
          WHERE EncryptedPassword IS NULL
      ");
  
      // 清理函数（可选）
      migrationBuilder.Sql(@"DROP FUNCTION dbo.EncryptPassword");
  }
  

• 优点：完全用SQL实现，迁移脚本简洁可复用，无需代码逻辑。
• 缺点：局限性极大，仅适用于可转成SQL的简单加密逻辑；自定义加盐、复杂加密算法无法实现。

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