C#基于App.config按配置切换不同数据库的方法

核心思路是对齐.NET原生环境识别逻辑，通过环境标识匹配配置文件内的对应连接串，不需要拆分多份配置文件，也不需要写复杂的环境分支判断。

1. 规范配置文件条目命名 #

所有环境的连接字符串统一存放在App.config的<connectionStrings>节点下，采用[连接名]_[环境标识]的格式命名，示例：

<connectionStrings>
  <add name="DefaultDb_Development" connectionString="Server=dev-sql;Database=app_dev;Uid=dev;Pwd=dev123;" providerName="System.Data.SqlClient" />
  <add name="DefaultDb_Staging" connectionString="Server=test-sql;Database=app_test;Uid=test;Pwd=test123;" providerName="System.Data.SqlClient" />
  <add name="DefaultDb_Production" connectionString="Server=prod-sql;Database=app_prod;Uid=prod;Pwd=prod@sec2024;" providerName="System.Data.SqlClient" />
</connectionStrings>

2. 统一读取运行环境标识 #

程序启动阶段优先读取ASPNETCORE_ENVIRONMENT环境变量（和.NET原生多环境逻辑保持一致，不需要额外新增配置项），未读取到值时默认回退到Development环境。
如果是传统.NET Framework项目，也可以通过编译常量、启动参数传递环境标识，保持和项目现有发布逻辑一致即可。

3. 封装连接字符串读取逻辑 #

不要直接硬编码key调用ConfigurationManager.ConnectionStrings，封装统一方法拼接当前环境后缀匹配对应配置：

using System.Configuration;

public static class DbConfigHelper
{
    public static string GetConnectionString(string dbName = "DefaultDb")
    {
        var currentEnv = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Development";
        var targetConfigKey = $"{dbName}_{currentEnv}";
        
        var connStr = ConfigurationManager.ConnectionStrings[targetConfigKey]?.ConnectionString;
        if (string.IsNullOrWhiteSpace(connStr))
        {
            throw new InvalidOperationException($"未找到{currentEnv}环境对应的数据库配置，key：{targetConfigKey}，请检查App.config配置");
        }
        return connStr;
    }
}

后续ORM（EF/EF Core/Dapper等）注册数据库实例时，直接调用该方法获取连接串即可，EF Core注册示例：

builder.Services.AddDbContext<AppDbContext>(opt =>
{
    opt.UseSqlServer(DbConfigHelper.GetConnectionString());
});

常见失效问题排查 #

• 检查App.config文件属性：确认「复制到输出目录」选项设置为「如果较新则复制」，很多切换失效是因为编译后输出目录的配置文件未更新，始终是旧版本内容
• .NET Core/.NET 6+项目需要先通过NuGet安装System.Configuration.ConfigurationManager包，否则ConfigurationManager相关API无法正常读取App.config内容
• 部署场景检查环境变量生效范围：IIS部署需要将对应应用池的「加载用户配置」设为true，否则无法读取到系统/用户级环境变量；容器/云服务部署需要确认启动时正确注入了ASPNETCORE_ENVIRONMENT变量
• 不要在业务代码中写if(环境是开发) return 开发连接串这类硬编码分支，所有连接串配置统一收敛到App.config，后续新增环境只需要在配置文件加一条对应条目即可，不需要修改业务代码

如果不想调整现有连接字符串的命名，也可以在App.config的appSettings节点单独加一个CurrentEnv配置项指定当前环境，读取连接串时用这个配置项的值做匹配即可。但更推荐用环境变量的方案，切换环境时不需要修改配置文件内容，避免生产环境发布时误改配置。

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