Azure环境变量未生效：Web应用无法覆盖AppSettings连接字符串

核心问题：环境变量命名格式不符合ASP.NET Core规则 #

ASP.NET Core对层级结构的配置项，环境变量需要用双下划线(__) 分隔层级。若你当前的环境变量命名未遵循此规则，就会导致无法覆盖ConnectionStrings:MySqlConn的配置。

解决步骤 #

1. 修正Azure环境变量名称 #

在Azure应用服务的「配置」→「应用程序设置」中，将连接字符串对应的环境变量名改为：
ConnectionStrings__MySqlConn
变量值填写你之前硬编码成功的Aiven MySQL完整连接字符串。

2. 验证配置加载（排查用） #

在Program.cs中添加日志输出，确认程序实际读取的连接字符串：

var builder = WebApplication.CreateBuilder(args);
var MySqlConnString = builder.Configuration.GetConnectionString("MySqlConn");

// 添加日志输出验证
var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
var logger = loggerFactory.CreateLogger<Program>();
logger.LogInformation("当前加载的连接字符串: {ConnStr}", MySqlConnString);

builder.Services.AddDbContext<AppDBContext>(options => 
    options.UseMySql(MySqlConnString, ServerVersion.AutoDetect(MySqlConnString)));

部署后在Azure门户的「日志流」中查看输出，确认是否加载了环境变量中的值。

3. 检查连接字符串与网络权限 #

• 确认Aiven MySQL的连接字符串无格式错误（比如多余字符、拼写错误）
• 在Aiven控制台的MySQL实例「网络」设置中，添加Azure应用服务的出站IP地址到IP白名单，确保网络连通

4. 重启Azure应用服务 #

修改环境变量后，必须重启应用服务才能让新配置生效。

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