ASP.NET Core API配置问题：如何用appsettings.custom.json覆盖默认配置

这种配置覆盖的需求完全可行，ASP.NET Core的配置系统本身就支持后添加的配置源覆盖先添加的配置源，你的问题大概率是路径或配置格式导致的，以下是具体排查和解决方法：

核心问题分析 #

你当前的代码逻辑是对的（先加载默认配置，再加载自定义配置，自定义项会覆盖默认项），但没生效可能是这几个原因：

• Windows服务运行时的工作目录和你预期的不一致，导致找不到appsettings.custom.json
• 自定义配置文件的JSON格式有误，加载失败被系统忽略
• 自定义配置的项层级和默认配置不匹配，无法完成覆盖

修正后的代码示例 #

用程序集路径获取更可靠的目录，避免Windows服务工作目录的不确定性：

private const string CustomAppSettingsJson = "appsettings.custom.json";
private const string DefaultAppSettingsJson = "appsettings.json";

// 获取程序集所在的实际目录，比AppDomain更可靠
var assemblyDir = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
var config = new ConfigurationBuilder()
    .SetBasePath(assemblyDir)
    .AddJsonFile(DefaultAppSettingsJson, optional: false, reloadOnChange: true)
    .AddJsonFile(CustomAppSettingsJson, optional: true, reloadOnChange: true)
    .Build();

注意：需要引用System.Reflection命名空间。

关键排查步骤 #

• 确认文件路径正确：在代码里添加日志或输出（服务可写入日志文件），打印Path.Combine(assemblyDir, CustomAppSettingsJson)的结果，检查文件是否确实存在于该路径下
• 校验JSON格式：把appsettings.custom.json的内容复制到JSON校验工具中，确保没有语法错误（比如缺失逗号、括号不匹配）
• 保持配置层级一致：比如默认配置结构是：

  {
    "ConnectionStrings": {
      "DefaultConnection": "Server=xxx;Database=xxx"
    },
    "Logging": {
      "LogLevel": {
        "Default": "Information"
      }
    }
  }
  

  要覆盖DefaultConnection，自定义配置必须保持相同层级：

  {
    "ConnectionStrings": {
      "DefaultConnection": "Server=yyy;Database=yyy"
    }
  }
  

  不能直接写"DefaultConnection": "xxx"，层级不匹配会导致无法覆盖
• 验证加载结果：在代码里打印配置值，比如Console.WriteLine(config.GetConnectionString("DefaultConnection"));，确认是否是自定义配置中的内容

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