.NET 6 Windows服务本地运行Kestrel配置未被覆盖问题咨询

问题根源 #

你的问题出在.NET配置系统对对象/集合类型配置的合并逻辑上：

• appsettings.json中的Kestrel:Endpoints是包含HTTPS端点的对象，appsettings.Local.json中的Kestrel:Endpoints是包含HTTP端点的对象
• .NET配置系统会合并这两个对象的键，最终Endpoints中同时存在HTTPS和HTTP两个端点
• 本地运行时XL Deploy不会替换appsettings.json中的{{API_URL}}令牌，导致加载HTTPS端点时出现无效URL错误

你提到的另一个类似服务无此问题，大概率是因为它的本地配置是直接覆盖了同一个端点的键（比如修改了"Default"端点的Url），而非添加新的端点键，所以不会出现端点共存的情况。

.NET 6配置覆盖机制说明 #

.NET配置系统的加载优先级从低到高为：

1. appsettings.json
2. appsettings.{Environment}.json（比如你使用的appsettings.Local.json）
3. 用户机密（仅限Development环境）
4. 环境变量
5. 命令行参数

注意：优先级高的配置只会覆盖相同路径的单个键值对，对于对象或数组类型，是合并结构而非替换整个对象/数组。比如：

• 若appsettings.json有Kestrel:Endpoints:Https:Url，appsettings.Local.json有Kestrel:Endpoints:Http:Url，最终两个键都会保留
• 只有当本地配置和主配置的键完全相同时（比如都有Kestrel:Endpoints:Default:Url），才会覆盖对应的值

解决方法 #

方法1：在本地配置中完全替换Kestrel Endpoints对象 #

在program.cs中，针对本地开发环境，先清空原有的Endpoints配置，再加载本地的HTTP端点：

var builder = WebApplication.CreateBuilder(args);

// 加载基础配置后，针对本地环境处理Kestrel配置
if (builder.Environment.IsDevelopment())
{
    // 清空原有的Endpoints配置
    builder.Configuration.GetSection("Kestrel:Endpoints").Value = null;
    // 添加本地HTTP端点配置
    builder.Configuration.AddInMemoryCollection(new Dictionary<string, string>
    {
        ["Kestrel:Endpoints:Http:Url"] = "http://localhost:9200"
    });
}

// 其他服务配置...

var app = builder.Build();
// ...

方法2：直接通过代码配置Kestrel（更直观） #

在program.cs中根据环境条件，直接配置Kestrel的端点，跳过配置文件的合并逻辑：

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.ConfigureKestrel(serverOptions =>
{
    if (builder.Environment.IsDevelopment())
    {
        // 本地开发直接配置HTTP端点
        serverOptions.ListenLocalhost(9200);
    }
    else
    {
        // 生产/UAT环境从配置文件加载HTTPS配置
        serverOptions.Configure(builder.Configuration.GetSection("Kestrel"));
    }
});

// 其他服务配置...

var app = builder.Build();
// ...

方法3：修改本地配置的键，覆盖主配置的端点 #

如果主配置中的Endpoints用的是命名端点（比如"HttpsInlineCertStore"），可以在appsettings.Local.json中直接覆盖该端点的Url为本地HTTP地址，同时删除证书配置：

// appsettings.Local.json
"Kestrel": {
  "Endpoints": {
    "HttpsInlineCertStore": {
      "Url": "http://localhost:9200",
      "Certificate": null
    }
  }
}

这种方式会直接替换主配置中"HttpsInlineCertStore"端点的参数，避免同时存在两个端点。

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