使用AddDbContextPool替代AddSqlServerDbContext时EF迁移失败：无法读取连接字符串

使用AddDbContextPool手动配置DbContext时，EF Core设计时工具（如dotnet ef migrations add）无法读取到Aspire AppHost提供的sqldata连接字符串。原因是：

• 官方AddSqlServerDbContext<T>方法内部集成了Aspire的设计时支持，能自动从AppHost或配置源中获取连接字符串。
• 手动调用AddDbContextPool时，未添加对应的设计时逻辑，设计时环境下builder.Configuration.GetConnectionString("sqldata")返回null，触发异常。

方案1：添加设计时DbContext工厂 #

创建实现IDesignTimeDbContextFactory<TicketContext>的类，专门为迁移提供连接字符串：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;

namespace SupportTicketApi.Api.Data;

public class TicketContextDesignTimeFactory : IDesignTimeDbContextFactory<TicketContext>
{
    public TicketContext CreateDbContext(string[] args)
    {
        var optionsBuilder = new DbContextOptionsBuilder<TicketContext>();
        // 填入AppHost中配置的SQL Server连接字符串
        var connectionString = "Server=localhost,14329;Database=sqldata;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True";
        
        optionsBuilder.UseSqlServer(connectionString)
                      .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking);

        return new TicketContext(optionsBuilder.Options);
    }
}

执行迁移命令时，EF会自动使用这个工厂创建TicketContext，绕开配置读取的问题。

方案2：在Api项目配置文件中添加连接字符串副本 #

在Api项目的appsettings.json中添加与AppHost一致的连接字符串：

{
  "ConnectionStrings": {
    "sqldata": "Server=localhost,14329;Database=sqldata;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True"
  }
}

设计时工具会读取这个配置，而运行时Aspire会覆盖该连接字符串，不影响生产环境。

方案3：执行迁移时指定连接字符串 #

直接在命令行中通过--connection参数传递连接字符串：

dotnet ef migrations add InitialCreate --connection "Server=localhost,14329;Database=sqldata;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True"

方案4：结合Aspire扩展配置DbContextPool #

保持EnrichSqlServerDbContext的同时，调整DbContext配置方式，确保设计时能获取配置：

builder.Services.AddDbContextPool<TicketContext>((serviceProvider, options) =>
{
    var configuration = serviceProvider.GetRequiredService<IConfiguration>();
    var connectionString = configuration.GetConnectionString("sqldata") ?? throw new InvalidOperationException("Could not read SQL Server connection string");
    
    options.UseSqlServer(connectionString)
           .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking);
});
builder.EnrichSqlServerDbContext<TicketContext>();

这种方式通过依赖注入获取IConfiguration，比直接使用builder.Configuration更兼容设计时环境，但仍需确保设计时配置中有sqldata连接字符串（可参考方案2）。

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