EntityFramework Core 中动态修改数据库连接字符串的正确方式

在开发使用 EntityFramework Core 的项目时，我们有时会遇到需要动态修改数据库连接字符串的场景。本文将以 PostgreSQL 数据库为例，深入探讨如何正确地在运行时更改 DbContext 的连接字符串。

常见误区与问题

许多开发者会尝试直接修改 DbConnection 对象的 ConnectionString 属性，代码如下：

if (!connectionString.IsNullOrWhiteSpace())
{
    dbContext.Database.GetDbConnection().ConnectionString = connectionString;
}
var migrator = dbContext.GetService<IMigrator>();
await migrator.MigrateAsync(migrationId).ConfigureAwait(false);

这种方法看似简单直接，但实际上存在严重问题。当通过 GetDbConnection() 获取连接对象并修改其 ConnectionString 后，虽然 DbContext 本身的连接字符串确实被更新了，但通过依赖注入获取的服务（如 IMigrator）仍然会使用旧的连接字符串。

问题根源分析

这种现象的原因是 EntityFramework Core 的内部设计机制：

1. 连接字符串在 DbContext 初始化时就被缓存到内部服务中
2. 直接修改 DbConnection 对象不会通知这些内部服务更新
3. IMigrator 等服务的连接信息是从内部服务容器获取的，而非直接从 DbContext 获取

正确的解决方案

EntityFramework Core 提供了专门的 API 来动态修改连接字符串：

if (!connectionString.IsNullOrWhiteSpace())
{
    dbContext.Database.SetConnectionString(connectionString);
}
var migrator = dbContext.GetService<IMigrator>();
await migrator.MigrateAsync(migrationId).ConfigureAwait(false);

SetConnectionString 方法不仅会更新 DbConnection 的连接字符串，还会确保所有相关服务都能获取到更新后的连接信息。

最佳实践建议

1. 避免直接操作 DbConnection：除非有特殊需求，否则应始终使用 EF Core 提供的 API 来修改连接配置

2. 考虑连接池影响：修改连接字符串后，旧的连接可能不会立即释放，需要注意连接池管理

3. 迁移场景的特殊性：数据库迁移操作对连接字符串特别敏感，确保在迁移前正确设置

4. 多租户应用：对于多租户应用，建议结合 DbContext 工厂模式使用，而非频繁修改连接字符串

通过理解这些底层机制，开发者可以避免许多与数据库连接相关的隐蔽问题，编写出更加健壮的应用程序。