在.NET Aspire中如何为同一数据库配置多个连接字符串？

需求说明 #

让MigrationService和ApiService连接同一个SQL Server数据库，但使用不同SQL用户（最小权限），同时保证本地开发与生产环境的EF Core DbContext注册逻辑一致。

1. 修改AppHost配置 #

在AppHost中为同一个数据库实例创建两个独立连接引用，分别对应不同配置键，让两个服务获取各自的连接字符串：

var builder = DistributedApplication.CreateBuilder(args);

// 添加SQL Server实例
var sqlServer = builder.AddSqlServer("sql");

// 为MigrationService创建数据库引用，绑定配置键"MigrationDb"
var migrationDb = sqlServer.AddDatabase("db")
                          .WithConnectionStringKey("MigrationDb");

// 为ApiService创建同一数据库的引用，绑定配置键"ApiDb"
var apiDb = sqlServer.AddDatabase("db")
                     .WithConnectionStringKey("ApiDb");

// 关联MigrationService到专属数据库引用
builder.AddProject<Projects.Parameters__MigrationService>("migrationservice")
       .WithReference(migrationDb);

// 关联ApiService到专属数据库引用
builder.AddProject<Projects.Parameters_ApiService>("api")
       .WithReference(apiDb);

builder.Build().Run();

2. 配置多环境连接字符串 #

在本地配置文件和生产环境配置中，分别定义两个连接字符串：

本地开发示例（appsettings.json） #

{
  "ConnectionStrings": {
    "MigrationDb": "Server=(localdb)\\mssqllocaldb;Database=db;Trusted_Connection=True;MultipleActiveResultSets=true",
    "ApiDb": "Server=(localdb)\\mssqllocaldb;Database=db;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

生产环境示例 #

{
  "ConnectionStrings": {
    "MigrationDb": "Server=tcp:sql.database.windows.net,1433;Initial Catalog=db;Persist Security Info=False;User ID=MigrationServiceUser;Password=MigrationServiceUserPassword;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;",
    "ApiDb": "Server=tcp:sql.database.windows.net,1433;Initial Catalog=db;Persist Security Info=False;User ID=ApiUser;Password=ApiUserPassword;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
  }
}

3. 注册EF Core DbContext #

在各服务的Program.cs中，使用对应配置键注册DbContext，保持环境逻辑一致：

MigrationService的DbContext注册 #

builder.AddSqlServerDbContext<MigrationServiceDbContext>("MigrationDb");

ApiService的DbContext注册 #

builder.AddSqlServerDbContext<ApiDbContext>("ApiDb");

保持DbContext继承关系（可选） #

如果MigrationServiceDbContext需要继承ApiDbContext，保留原有逻辑即可：

public class MigrationServiceDbContext(DbContextOptions<MigrationServiceDbContext> options) : ApiDbContext(options);

此配置实现了本地开发可共用同一连接、生产环境用不同SQL用户实现最小权限的目标，且DbContext注册逻辑在两个环境完全一致。

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