ASP.NET Core(.NET6)如何在Linux环境加载专属appSettings配置文件

原有代码不生效的核心原因 #

• 你手动new了一个完全独立的IConfigurationBuilder实例，和WebApi默认的配置构建管线没有任何关联，最终Build()生成的配置对象没有注入到应用服务容器中，完全不会被应用读取
• 独立构建的配置没有和默认加载的appSettings.json做优先级覆盖，默认配置的加载逻辑不受你这段代码的任何影响
• 未配置JSON文件的输出规则，appSettings.Linux.json大概率没有被拷贝到Linux部署目录，就算配置逻辑写对了也找不到对应文件

原有错误写法操作截图

正确实现步骤 #

1. 修改Program.cs配置加载逻辑
   不要自行新建配置构建器，直接在WebApplication.CreateBuilder生成的默认builder上追加配置源，注意配置源的注册顺序：后注册的配置源优先级更高，会覆盖之前加载的同名配置项。
   完整代码示例：

   using System.Runtime.InteropServices;
   
   var builder = WebApplication.CreateBuilder(args);
   
   // 判定运行环境为Linux时，追加专属配置文件，放在默认配置加载完成后执行，实现同key覆盖
   if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
   {
       builder.Configuration.AddJsonFile(
           path: "appSettings.Linux.json",
           optional: false, // 生产环境建议设为非可选，文件缺失时直接抛出异常，避免静默使用默认配置引发线上故障
           reloadOnChange: true
       );
   }
   
   // 以下保留你原有的服务注册、中间件配置逻辑即可
   builder.Services.AddControllers();
   // ... 其他服务注册代码
   
   var app = builder.Build();
   
   // ... 其他中间件配置代码
   app.Run();
   

2. 配置文件复制规则
   在解决方案资源管理器中右键appSettings.Linux.json，打开属性面板，将复制到输出目录选项设置为如果较新则复制，确保执行发布操作时，该文件会被同步到发布产物目录，不会出现Linux环境下文件缺失的问题。

补充说明：如果需要更灵活的环境适配，也可以直接使用.NET原生的环境变量配置方案，通过启动时设置ASPNETCORE_ENVIRONMENT=Linux，直接使用默认的appSettings.{环境名}.json加载逻辑，不需要手动判断操作系统，适配性更强。

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