ASP.NET Core EF Code First迁移无法读取环境变量问题

我碰到过好几次这种情况，尤其是DbContext不在API主程序集的时候，设计时工具的配置加载逻辑确实容易掉坑。下面给你两个靠谱的解决方案，按需选就行：

方案一：在DesignTimeDbContextFactory里手动加载环境变量和配置 #

这个方案最直接，把配置加载逻辑完全掌控在自己手里，确保环境变量能被正确读取：

public class DesignTimeDbContextFactory : IDesignTimeDbContextFactory<MyDbContext>
{
    public MyDbContext CreateDbContext(string[] args)
    {
        // 先获取环境变量，没设置就默认用Development
        var envName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Development";

        // 构建配置，这里要注意路径问题！
        var configBuilder = new ConfigurationBuilder()
            // 如果DbContext项目和API项目在同一根目录，直接用GetCurrentDirectory就行
            // 如果不在，得调整路径指向API项目的根目录，比如 "../YourApiProjectName"
            .SetBasePath(Directory.GetCurrentDirectory())
            // 加载基础配置文件
            .AddJsonFile("appsettings.json", optional: false)
            // 加载对应环境的配置文件
            .AddJsonFile($"appsettings.{envName}.json", optional: true)
            // 关键一步：加载系统/终端里的环境变量
            .AddEnvironmentVariables()
            .Build();

        // 从配置里拿连接字符串
        var connectionString = configBuilder.GetConnectionString("DefaultConnection");

        var options = new DbContextOptionsBuilder<MyDbContext>();
        // 这里替换成你用的数据库提供商，比如UseSqlite/UseNpgsql
        options.UseSqlServer(connectionString);

        return new MyDbContext(options.Options);
    }
}

重点注意： #

• 路径问题：如果你的DbContext项目和API项目不在同一个文件夹，比如API在src/WebApi，DbContext在src/Data，那Directory.GetCurrentDirectory()返回的是Data项目的目录，这时候得改成Path.Combine(Directory.GetCurrentDirectory(), "../WebApi")，确保能找到API里的appsettings文件。
• 环境变量设置：运行迁移命令前，得在当前终端里设置好环境变量：
  • Windows命令行：set ASPNETCORE_ENVIRONMENT=Staging
  • PowerShell：$env:ASPNETCORE_ENVIRONMENT="Staging"
  • Linux/macOS：export ASPNETCORE_ENVIRONMENT=Staging

方案二：指定启动项目让工具复用API的配置逻辑 #

如果你的API项目里已经有完善的配置加载逻辑（包括环境变量），可以让EF工具直接复用它，不用自己写配置：

运行迁移命令的时候，明确指定启动项目（也就是你的API项目）和DbContext所在项目：

dotnet ef migrations add InitialCreate --project YourDataProjectName --startup-project YourApiProjectName

如果用Visual Studio的Package Manager Console：

1. 把API项目设置为启动项目
2. 在Package Manager Console的"默认项目"下拉框里选DbContext所在项目
3. 直接运行Add-Migration InitialCreate

这样EF设计时工具会启动你的API项目的Startup逻辑，自然就能读取到环境变量和对应环境的配置了，和API运行时的配置逻辑完全一致。

为什么原来的代码读不到环境变量？ #

大概率是你的Configuration属性没有显式调用AddEnvironmentVariables()，或者没有加载对应环境的配置文件。设计时工具不会自动继承API项目的配置加载流程，得手动把环境变量加入到配置源里才行。

内容的提问来源于stack exchange，提问作者Tom Troughton