Azure App Service中ASP.NET Core应用配置加载异常问题求助

我之前也碰到过一模一样的糟心事！明明在Azure App Service里把ASPNETCORE_ENVIRONMENT设成了Production，结果应用还是死咬着Development的配置不放，折腾了好一阵才把各种坑踩遍，给你列几个最值得优先排查的点：

• 先确认Azure App Service的环境变量真的生效了
  别只盯着门户的配置页面看，得实际验证。打开App Service的「高级工具」进入Kudu控制台，选CMD或PowerShell，输入对应命令查看：

  • Windows环境：echo %ASPNETCORE_ENVIRONMENT%
  • Linux环境：echo $env:ASPNETCORE_ENVIRONMENT
    看看输出是不是Production。有时候可能是设置后没点保存，或者部署过程中被自动覆盖了。另外要记住：App Service应用设置里的环境变量优先级是高于本地配置文件的，但前提是这个变量真的被正确设置了。

• 检查发布包是否意外包含了launchsettings.json
  本地开发时launchsettings.json里的环境变量会生效，但如果发布时不小心把这个文件也打包进去，Azure启动应用时可能会读取它的设置，直接覆盖你在门户里配置的环境变量。解决方法是在项目的.csproj文件里添加排除规则，确保发布时不带这个文件：

  <ItemGroup>
    <Content Remove="Properties\launchSettings.json" />
    <None Include="Properties\launchSettings.json" CopyToPublishDirectory="Never" />
  </ItemGroup>
  

• 确认HostBuilder没有硬编码环境
  虽然你说用的是默认模板，但还是要再核对下Program.cs的代码，有没有类似这样的硬编码：

  var host = Host.CreateDefaultBuilder(args)
      .UseEnvironment("Development") // 这行会强制锁定开发环境
      .ConfigureWebHostDefaults(webBuilder =>
      {
          webBuilder.UseStartup<Startup>();
      });
  

  如果有，直接删掉这行，让应用自动读取环境变量。

• 排查配置加载的优先级冲突
  ASP.NET Core的配置加载是有优先级顺序的（从低到高）：appsettings.json → appsettings.{Environment}.json → 环境变量 → 命令行参数。如果你的应用有其他地方设置了环境变量（比如用容器部署时的Dockerfile、自定义启动脚本），可能会覆盖Azure门户的设置。比如Dockerfile里如果写了ENV ASPNETCORE_ENVIRONMENT Development，那必须改成Production或者删掉这行。

• 添加日志验证配置加载情况
  可以在Startup构造函数或者Program.cs里加一段日志，把当前环境和加载的配置信息打出来，方便排查：

  public Startup(IConfiguration configuration, IWebHostEnvironment env)
  {
      Configuration = configuration;
      // 输出到控制台，Azure日志流里能看到
      Console.WriteLine($"当前运行环境: {env.EnvironmentName}");
      Console.WriteLine($"加载的配置项路径: {string.Join(", ", configuration.GetChildren().Select(c => c.Path))}");
  }
  

  然后去Azure App Service的「日志流」里看输出，确认当前环境是不是Production，有没有加载appsettings.Production.json。

• 检查自定义启动命令
  如果在App Service的「配置→常规设置→启动命令」里填了自定义命令，要确保没有指定环境参数，比如dotnet MyApp.dll --environment Development这种写法会强制用开发环境。如果有，把--environment Development去掉，让应用自动读取环境变量。

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