如何用EF Core实现ASP.NET Core API动态连接多数据库？或改用SqlClient？

EF Core支持动态配置，无需为每个客户创建Context #

EF Core完全支持通过动态构建连接字符串来连接不同客户的数据库，核心是在创建DbContext实例时，传入自定义的DbContextOptions，而非依赖固定配置。

实现步骤示例 #

1. 定义基础DbContext

public class CustomerDbContext : DbContext
{
    public CustomerDbContext(DbContextOptions<CustomerDbContext> options) : base(options)
    {
    }

    // 映射客户数据库中的实体
    public DbSet<Order> Orders { get; set; }
    public DbSet<CustomerProfile> CustomerProfiles { get; set; }
}

2. 动态构建连接字符串并创建Context
   从主数据库获取客户的连接信息（服务器名、端口、数据库名、密码等）后，直接构建连接字符串并初始化Context：

// 从主库查询到的客户连接信息
var customerConn = await _mainContext.CustomerConnections
    .FirstOrDefaultAsync(c => c.CustomerName == targetCustomerName);

if (customerConn == null)
{
    // 处理客户不存在的情况
}

// 构建SQL Server连接字符串
var connStr = $"Server={customerConn.ServerName},{customerConn.Port};Database={customerConn.DbName};User Id={customerConn.DbUser};Password={customerConn.DbPassword};TrustServerCertificate=True;";

// 生成Context配置
var dbOptions = new DbContextOptionsBuilder<CustomerDbContext>()
    .UseSqlServer(connStr)
    .Options;

// 使用动态配置的Context
using var customerDb = new CustomerDbContext(dbOptions);
var customerOrders = await customerDb.Orders.Where(o => o.IsActive).ToListAsync();

EF Core的内置支持与优化方式 #

EF Core本身没有专门的"多租户动态连接"工具，但DbContextOptionsBuilder就是官方推荐的动态配置入口。为了避免重复代码，可封装工厂模式来复用Context创建逻辑：

注册Context工厂服务 #

在API的依赖注入容器中注册工厂：

// Program.cs
builder.Services.AddScoped<ICustomerDbFactory, CustomerDbFactory>();

// 工厂接口与实现
public interface ICustomerDbFactory
{
    CustomerDbContext Create(CustomerConnection connInfo);
}

public class CustomerDbFactory : ICustomerDbFactory
{
    public CustomerDbContext Create(CustomerConnection connInfo)
    {
        var connStr = $"Server={connInfo.ServerName},{connInfo.Port};Database={connInfo.DbName};User Id={connInfo.DbUser};Password={connInfo.DbPassword};TrustServerCertificate=True;";
        var options = new DbContextOptionsBuilder<CustomerDbContext>()
            .UseSqlServer(connStr)
            .Options;
        return new CustomerDbContext(options);
    }
}

在控制器中使用工厂 #

public class CustomerDataController : ControllerBase
{
    private readonly ICustomerDbFactory _dbFactory;
    private readonly MainDbContext _mainContext;

    public CustomerDataController(ICustomerDbFactory dbFactory, MainDbContext mainContext)
    {
        _dbFactory = dbFactory;
        _mainContext = mainContext;
    }

    [HttpGet("{customerId}/orders")]
    public async Task<IActionResult> GetOrders(int customerId)
    {
        var connInfo = await _mainContext.CustomerConnections.FindAsync(customerId);
        if (connInfo == null) return NotFound();

        using var customerDb = _dbFactory.Create(connInfo);
        var orders = await customerDb.Orders.ToListAsync();
        return Ok(orders);
    }
}

是否改用SqlClient更合适？ #

• 如果你的数据操作仅涉及简单SQL语句、存储过程，无需ORM特性（LINQ、变更跟踪、实体映射），直接用SqlClient（SqlConnection、SqlCommand）会更轻量，减少EF Core的额外开销。
• 若需要利用EF Core的ORM能力简化开发、维护实体关系，优先选择EF Core的动态配置方案，其开发效率和可维护性更高。

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