ASP.NET Core服务器环境专属appsettings.json未生效，全环境读默认配置

核心问题根因 #

你遇到的场景本质是两个常见的配置加载坑叠加导致的：

• 配置文件命名和环境标识不匹配：.NET 框架加载环境专属配置文件时，会严格按照appsettings.{环境标识值}.json的字符串完全匹配查找文件。如果服务器没有手动设置ASPNETCORE_ENVIRONMENT环境变量，框架会默认使用Production作为环境标识，此时会查找appsettings.Production.json，但你项目里放的是全小写的appsettings.prod.json，文件名完全对不上，自然加载失败。同理UAT环境下，框架默认找的是appsettings.UAT.json，和你项目里的appsettings.uat.json也无法匹配。
• 冗余的自定义配置加载打乱了优先级：Host.CreateDefaultBuilder本身已经内置了完整的配置加载流程，按顺序会加载基础appsettings.json、对应环境的appsettings文件、环境变量、命令行参数等。你手动在ConfigureAppConfiguration里重复添加了一遍json配置，反而让后加载的基础appsettings.json的优先级高于之前加载的环境专属配置，最终表现为所有环境都只生效默认的appsettings.json内容。

具体修正步骤 #

• 统一配置匹配规则
  • 如果你不打算自定义环境标识值，直接把项目里的文件重命名为和默认规则匹配的名称：
    • 原appsettings.development.json重命名为appsettings.Development.json
    • 原appsettings.prod.json重命名为appsettings.Production.json
    • 原appsettings.uat.json重命名为appsettings.UAT.json
  • 如果你想保留全小写的文件名，就保证部署时设置的ASPNETCORE_ENVIRONMENT值和文件名段完全一致：比如要使用prod文件名段，就把环境变量值设为prod，不要用默认的Production。
• 给每个部署节点配置正确的环境变量
  • Windows服务器：在系统环境变量中新增ASPNETCORE_ENVIRONMENT，值对应部署的环境名即可。
  • Linux服务器：在服务启动脚本（systemd配置、启动bash脚本）中增加导出语句，示例：export ASPNETCORE_ENVIRONMENT=Production
  • 本地开发：直接在项目的launchSettings.json中配置对应启动场景的环境变量即可，不需要修改系统全局变量。
• 删掉冗余的自定义配置加载逻辑
  由于CreateDefaultBuilder已经实现了你手写的所有json加载逻辑，手动添加的代码完全多余，修正后的Program.cs参考如下：

  public class Program
  {
      public static void Main(string[] args)
      {
          CreateHostBuilder(args).Build().Run();
      }
  
      public static IHostBuilder CreateHostBuilder(string[] args) =>
          Host.CreateDefaultBuilder(args)
              .ConfigureWebHostDefaults(webBuilder =>
              {
                  webBuilder.UseStartup<Startup>();
              });
  }
  

• 修正文件的发布属性
  选中项目中所有的appsettings.json文件，在属性面板中将复制到输出目录设置为如果较新则复制，避免发布时环境专属的json文件没有被打包到输出目录，导致程序找不到文件只能加载默认配置。

验证方法 #

程序启动时可以直接打印当前的运行环境标识和已加载的配置源列表：

• 先确认输出的当前环境名和你预期设置的环境值完全一致，如果不一致说明环境变量没有正确生效。
• 再检查发布包的输出目录下，是否存在对应环境名的json配置文件，如果文件缺失，就是文件复制属性配置错误。

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