部署到Azure AppService后环境变量无法识别的问题求助

我来帮你排查这个问题，这类情况在.NET Core部署到Azure App Service时挺常见的，咱们一步步来定位：

1. 确认Azure环境变量的配置格式是否正确 #

首先要注意，Azure App Service的应用程序设置里的键名格式和appsettings.json里的不一样：

• 如果你的本地配置是ConnectionStrings:DefaultConnection，在Azure里必须写成ConnectionStrings__DefaultConnection（用双下划线代替冒号），因为环境变量不支持冒号作为分隔符，这是很多人踩坑的核心点！
• 去Azure Portal的App Service页面，进入配置 > 应用程序设置，检查你添加的键名是否符合这个格式，值是否正确。

2. 检查.NET Core的配置读取优先级 #

.NET Core默认的配置读取顺序是：本地用户机密（开发环境）> 环境变量 > 环境特定appsettings > 全局appsettings。也就是说环境变量优先级是高于appsettings.json的，但如果你的代码里手动修改了配置源的顺序，可能会导致环境变量被覆盖。

• 打开你的Program.cs，确认是否保留了默认的环境变量配置：

var builder = WebApplication.CreateBuilder(args);
// 默认已经包含AddEnvironmentVariables()，如果手动添加了配置源，确保这一行在正确的位置
builder.Configuration.AddEnvironmentVariables();

如果把AddJsonFile放在AddEnvironmentVariables之后，就会导致appsettings覆盖环境变量，这是要避免的。

3. 验证环境变量是否真的被注入到App Service中 #

有时候配置看起来加了，但实际没生效，咱们可以验证一下：

• 进入App Service的高级工具 > Kudu，打开调试控制台 > PowerShell，输入Get-ChildItem Env:，查看所有环境变量，确认你添加的配置项是否存在，键名是否和你设置的一致。
• 也可以临时加一个测试接口（记得之后删除或者脱敏），返回当前配置的所有项：

[HttpGet("debug/config")]
public IActionResult GetCurrentConfig()
{
    var safeConfig = new Dictionary<string, string>();
    foreach (var item in Configuration.AsEnumerable())
    {
        // 敏感信息脱敏处理
        if (item.Key.Contains("ConnectionString") || item.Key.Contains("Secret"))
        {
            safeConfig[item.Key] = item.Value?.Substring(0, 20) + "...";
        }
        else
        {
            safeConfig[item.Key] = item.Value;
        }
    }
    return Ok(safeConfig);
}

部署后访问这个接口，看看你配置的环境变量是否出现在返回结果里。

4. 确认应用的运行环境设置 #

Azure App Service默认的ASPNETCORE_ENVIRONMENT是Production，而你本地调试用的是Development。如果你的代码里有针对不同环境的配置逻辑，要确保这个环境变量设置正确：

• 在配置 > 应用程序设置里检查ASPNETCORE_ENVIRONMENT的值，是否和你预期的一致（比如Production、Staging等）。

5. 关于appsettings.json无法读取的问题 #

如果你把配置放到appsettings.json里还是读不到，可能是部署时文件没上传成功：

• 去Kudu的wwwroot目录，查看是否存在appsettings.json，以及文件内容是否和你本地的一致。
• 如果用CI/CD工具（比如GitHub Actions、Azure DevOps）部署，要确保部署任务包含了appsettings.json文件，没有被忽略。

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