EF Core 通过 ASP.net Core 配置系统和 DI 实现环境差异化配置:按环境加载 appsettings.{Environment}.json 中的连接字符串,开发环境启用迁移与日志,生产环境禁用自动迁移、关闭敏感数据日志,迁移脚本需指定环境生成。

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()。