C#中app.Run()执行失败：UseKestrel()未等待Defaults配置完成

问题分析 #

你遇到的错误提示"The endpoint HttpsInlineCertFile is missing the required 'Url' parameter."，核心原因是Kestrel的端点配置存在冲突或不完整：要么配置文件中存在未指定Url的Https端点配置，要么代码中的Kestrel配置未正确生效，导致ServerCertificate未被正确加载，触发了默认的Https端点配置校验。

解决方案 #

1. 检查并修正配置文件中的Kestrel端点配置 #

打开appsettings.json或appsettings.Development.json，查看Kestrel节点下的Endpoints配置。如果存在HttpsInlineCertFile端点但未指定Url，会直接触发该错误。

错误示例：

"Kestrel": {
  "Endpoints": {
    "HttpsInlineCertFile": {
      "Certificate": {
        "Path": "./cert.pfx",
        "Password": "123456"
      }
      // 缺少Url配置项
    }
  }
}

修正方式：

• 补全Url配置：

"Kestrel": {
  "Endpoints": {
    "HttpsInlineCertFile": {
      "Url": "https://localhost:5001",
      "Certificate": {
        "Path": "./cert.pfx",
        "Password": "123456"
      }
    }
  }
}

• 或者直接删除该端点配置（如果已经通过代码指定ServerCertificate），避免配置冲突。

2. 确保代码中Kestrel配置的调用时机和优先级 #

方法二（builder.WebHost.UseKestrel）是.NET Core/.NET 5+推荐的Kestrel配置方式，但必须保证在builder.Build()之前调用，否则配置不会生效。

正确的调用顺序：

var builder = WebApplication.CreateBuilder(args);

// 第一步：调用自定义Kestrel配置扩展
builder.UseKestrel();

// 第二步：添加其他服务
builder.Services.AddControllers();
// ...其他服务注册

// 第三步：构建应用
var app = builder.Build();

// 中间件配置
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

// 启动应用
app.Run();

3. 验证证书加载逻辑的有效性 #

调试确认LoadCertificate()方法能正确返回有效的X509Certificate2实例，避免因证书加载失败导致配置逻辑失效。可以添加异常抛出或日志输出：

private static X509Certificate2 LoadCertificate()
{
    var certPath = Path.Combine(AppContext.BaseDirectory, "server.pfx");
    if (!File.Exists(certPath))
    {
        throw new FileNotFoundException("Server certificate file not found", certPath);
    }

    try
    {
        return new X509Certificate2(certPath, "your-cert-password", X509KeyStorageFlags.MachineKeySet);
    }
    catch (Exception ex)
    {
        throw new InvalidOperationException("Failed to load server certificate", ex);
    }
}

4. 统一Kestrel配置方式 #

避免混合使用方法一（Configure<KestrelServerOptions>）和方法二（WebHost.UseKestrel），因为后者的配置优先级更高，可能覆盖前者的设置。推荐统一使用方法二的方式，更直观且易于排查问题。

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