如何通过appsetting.development.json覆盖Kestrel证书配置，使开发环境无需证书？

问题背景 #

当前项目的配置及初始化代码如下：

appsettings.json中的Kestrel配置 #

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://0.0.0.0:7514"
    },
    "Https": {
      "Url": "https://0.0.0.0:7513",
      "Certificate": {
        "Path": "myCert.pfx",
        "Password": "somePassword"
      }
    }
  }
}

appsettings.development.json中的Kestrel配置 #

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://0.0.0.0:7514"
    },
    "Https": {
      "Url": "https://0.0.0.0:7515"
    }
  }
}

项目初始化代码 #

var webApplicationOptions = new WebApplicationOptions() { 
    ContentRootPath = AppContext.BaseDirectory, 
    Args = args, 
    ApplicationName = System.Diagnostics.Process.GetCurrentProcess().ProcessName 
};
var builder = WebApplication.CreateBuilder(webApplicationOptions);
builder.Host.UseWindowsService(); 

开发模式下，系统会使用开发配置的端口7515，但仍要求提供证书——原因是ASP.NET Core的配置系统会叠加基础配置（appsettings.json）的证书项，开发配置未显式覆盖该字段，导致证书要求依然生效。

解决方案 #

方法一：通过配置文件显式覆盖证书配置 #

修改appsettings.development.json，在Https端点中显式处理证书配置，有两种可选方案：

方案1：完全移除证书要求

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://0.0.0.0:7514"
    },
    "Https": {
      "Url": "https://0.0.0.0:7515",
      "Certificate": null
    }
  }
}

方案2：使用自动生成的开发证书

如果需要保留HTTPS但不想手动配置证书，可以指定使用ASP.NET Core自动生成的开发证书：

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://0.0.0.0:7514"
    },
    "Https": {
      "Url": "https://0.0.0.0:7515",
      "Certificate": {
        "Subject": "localhost",
        "Store": "My",
        "Location": "CurrentUser"
      }
    }
  }
}

方法二：通过代码在开发环境动态修改配置 #

在项目初始化代码中，判断当前环境为开发模式时，直接调整Kestrel的端点配置：

var webApplicationOptions = new WebApplicationOptions() { 
    ContentRootPath = AppContext.BaseDirectory, 
    Args = args, 
    ApplicationName = System.Diagnostics.Process.GetCurrentProcess().ProcessName 
};
var builder = WebApplication.CreateBuilder(webApplicationOptions);
builder.Host.UseWindowsService();

// 仅在开发环境下修改Kestrel配置
if (builder.Environment.IsDevelopment())
{
    builder.WebHost.ConfigureKestrel(options =>
    {
        var httpsEndpoint = options.ConfigurationEndpoint("Https");
        if (httpsEndpoint != null)
        {
            // 移除证书要求
            httpsEndpoint.ConfigureEndpoint(config => config.Certificate = null);
            
            // 或者替换为开发证书（二选一即可）
            // httpsEndpoint.ConfigureEndpoint(config => config.UseDevelopmentCertificate());
        }
    });
}

// 后续服务注册、中间件配置逻辑...

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

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