EF Core 本身不直接处理环境切换,而是通过 ASP.NET Core 的配置系统(
IConfiguration)和依赖注入(DI)机制,配合不同环境的
appsettings.{Environment}.json 文件,实现数据库连接字符串、迁移行为等的差异化配置。
按环境加载不同连接字符串
在
Program.cs(.NET 6+)中注册 DbContext 时,从
IConfiguration获取对应环境的连接字符串即可:
builder.Services.AddDbContext<AppDbContext>(options =>
{
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
options.UseSqlServer(connectionString);
});
然后在不同配置文件中定义连接字符串:
appsettings.Development.json:用本地 SQL Server 或 LocalDB,支持迁移和敏感日志
appsettings.Production.json:用云数据库地址,关闭敏感日志,禁用自动迁移
appsettings.Staging.json:介于两者之间,可启用只读迁移检查
避免生产环境自动迁移
EF Core 的
MigrateAsync()或
Database.Migrate()在启动时执行迁移,开发环境可用,但生产环境应禁用——改用显式 SQL 脚本或 CI/CD 流水线部署。
推荐做法是条件性调用:
if (app.Environment.IsDevelopment())
{
using var scope = app.Services.CreateScope();
scope.ServiceProvider.GetRequiredService<AppDbContext>().Database.Migrate();
}
环境感知的 DbContext 配置
可在
OnConfiguring或
AddDbContext中根据环境做微调: 开发环境:启用详细错误、记录 SQL 日志(
LogTo(Console.WriteLine)) 生产环境:关闭敏感数据日志(
EnableSensitiveDataLogging(false))、启用查询计划缓存 测试环境:使用
InMemoryDatabase或
Sqlite in-memory
例如:
optionsBuilder
.UseSqlServer(connectionString)
.EnableSensitiveDataLogging(builder.Environment.IsDevelopment())
.LogTo(Console.WriteLine, LogLevel.Information);
迁移脚本按环境生成
使用 CLI 命令指定启动项目和环境,确保迁移基于正确的配置生成:
dotnet ef migrations add Init --project MyApp.Infrastructure --startup-project MyApp.Web --environment Development dotnet ef migrations script --project MyApp.Infrastructure --startup-project MyApp.Web --environment Production -o deploy-prod.sql
注意:
--environment参数会触发加载对应
appsettings.{env}.json,影响连接字符串和配置行为。
基本上就这些。核心逻辑是“环境由 ASP.NET Core 控制,EF Core 只负责用好传给它的配置”。不复杂但容易忽略细节,比如忘了在生产环境关掉
EnableSensitiveDataLogging,或者误在上线时执行了
Migrate()。
