.NET Aspire项目执行EF迁移时连接字符串异常问题求助

我正在.NET Aspire项目中添加初始迁移，使用的是Aspire.Pomelo.EntityFrameworkCore.MySql组件，相关代码如下：

AppHost代码 #

var builder = DistributedApplication.CreateBuilder(args);

//var mysqlPassword = builder.AddParameter("sql-password", secret: true);

var mysqlDbContainer = builder.AddMySql("mysql-db-container").WithDataVolume();
var identityDbCatalog = mysqlDbContainer.AddDatabase("identitydb");

builder.AddProject<Projects.SchoolFee_IdentityService>("identityservice").WithReference(identityDbCatalog);

builder.Build().Run();

微服务代码 #

var builder = WebApplication.CreateBuilder(args);

builder.AddMySqlDbContext<IdentityServiceDbContext>("identitydb");
builder.AddServiceDefaults();
...

执行dotnet ef migrations add Initial命令时，出现以下错误：

Execution attempt. Source: 'Microsoft.Extensions.Hosting.AspireEFMySqlExtensions.ServerVersion/(null)/Retry', Operation Key: '', Result: 'Access denied for user ''@'172.17.0.1' (using password: NO)', Handled: 'False', Attempt: '0', Execution Time: 209.9911ms
      MySqlConnector.MySqlException (0x80004005): Access denied for user ''@'172.17.0.1' (using password: NO)

调试运行时连接字符串能正常工作，请问如何创建可在部署时应用的迁移？

解决方案 #

问题根源 #

单独执行dotnet ef命令时，不会启动.NET Aspire的AppHost，因此无法自动获取MySQL容器的用户名、密码等连接信息，导致连接失败；而调试时AppHost会自动注入这些配置，所以能正常连接。

具体解决步骤 #

1. 临时指定连接字符串执行迁移

直接在迁移命令中传入有效的MySQL连接字符串，确保和Aspire启动的MySQL容器凭证匹配：

dotnet ef migrations add Initial --connection "server=localhost;database=identitydb;user=root;password=你的MySQL密码;"

注意：默认Aspire的MySQL容器用户名为root，密码如果未手动设置，可在AppHost启动时的日志中找到自动生成的随机密码。

2. 配置固定MySQL密码，统一调试与迁移环境

取消AppHost中密码参数的注释，设置固定密码：

var mysqlPassword = builder.AddParameter("sql-password", secret: true, defaultValue: "YourStrongPassword");
var mysqlDbContainer = builder.AddMySql("mysql-db-container", password: mysqlPassword).WithDataVolume();

在微服务的appsettings.json中添加对应连接字符串配置：

{
  "ConnectionStrings": {
    "identitydb": "server=localhost;database=identitydb;user=root;password=YourStrongPassword;"
  }
}

之后执行迁移命令即可：

dotnet ef migrations add Initial --environment Development

3. 启动AppHost后再执行迁移

先在终端启动AppHost，确保MySQL容器正常运行：

dotnet run --project AppHost

打开新终端，进入微服务项目目录执行迁移命令，此时Aspire的配置会被自动加载：

cd ./SchoolFee_IdentityService
dotnet ef migrations add Initial

4. 部署时应用迁移

部署时可通过两种方式应用迁移：

• 启动时自动应用：在微服务的Program.cs中添加迁移执行代码，启动时自动更新数据库：

  var app = builder.Build();
  using (var scope = app.Services.CreateScope())
  {
      var dbContext = scope.ServiceProvider.GetRequiredService<IdentityServiceDbContext>();
      dbContext.Database.Migrate();
  }
  // 其他中间件配置
  app.Run();
  

• 部署流程中手动执行：使用dotnet ef database update命令，确保部署环境的连接字符串配置正确即可。

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