VS2022中Open API服务启用HTTP随机端口及浏览器弹窗问题

核心问题：为Open API服务启用HTTP随机端口并解决ERR_INVALID_HTTP_RESPONSE错误 #

方法1：通过launchSettings.json直接配置（推荐） #

在项目的Properties/launchSettings.json中，将HTTP端口设为0（表示随机分配端口），同时保留HTTPS固定端口：

"profiles": {
  "Your_OpenAPI_Project": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "launchUrl": "swagger",
    "applicationUrl": "https://localhost:61050;http://localhost:0",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

解决ERR_INVALID_HTTP_RESPONSE报错：

• 检查强制HTTPS重定向逻辑：如果代码中有app.UseHttpsRedirection();，HTTP请求会被重定向到HTTPS，若重定向目标不可达或逻辑异常会触发该错误。若需同时支持HTTP和HTTPS，可暂时注释该行，或通过条件中间件仅对特定路径启用重定向：

  // 仅对非健康检查路径启用HTTPS重定向
  app.UseWhen(context => !context.Request.Path.StartsWithSegments("/health"), appBuilder =>
  {
      appBuilder.UseHttpsRedirection();
  });
  

• 查看Kestrel启动日志，确认HTTP随机端口已被正确监听，确保请求发送到服务实际分配的端口。

方法2：通过ConfigureKestrel代码配置 #

若必须通过代码配置Kestrel，需同时指定HTTPS固定端口和HTTP随机端口，避免覆盖原有配置导致服务仅监听单一端口：

builder.WebHost.ConfigureKestrel(serverOptions =>
{
    // 绑定HTTPS固定端口，使用开发证书
    serverOptions.ListenLocalhost(61050, listenOptions =>
    {
        listenOptions.UseHttps();
    });
    // 绑定HTTP随机端口（0表示随机分配）
    serverOptions.ListenLocalhost(0);
});

次要问题：builder.WebHost.ConfigureKestrel影响浏览器自动弹窗的原因 #

VS调试时的自动弹窗依赖launchSettings.json中的applicationUrl和launchBrowser配置：

1. 端口覆盖问题：ConfigureKestrel的代码配置会直接覆盖launchSettings.json中的applicationUrl设置，VS无法提前预知服务实际监听的随机端口，因此无法自动打开对应URL。
2. 配置冲突：若代码中仅配置了HTTP随机端口，未保留HTTPS端口，而launchSettings.json的launchUrl指向HTTPS地址，VS尝试打开的URL无法访问，会自动取消弹窗行为。

如需保留自动弹窗，优先使用launchSettings.json配置随机端口，而非硬编码ConfigureKestrel。

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