.NET 7本地发布Web API无HTTPS端点及请求失败问题

问题核心 #

本地发布后HTTPS请求失败，添加HttpsRedirection配置后反而全端口无法连接，本质是应用未实际监听HTTPS端口+证书/重定向配置不匹配导致的。

具体解决步骤 #

• 让Kestrel同时监听HTTP和HTTPS端口
  必须明确指定Kestrel的监听端口，否则重定向指令发出后没有服务响应。

  • 方式1：修改appsettings.json配置文件

    "Kestrel": {
      "Endpoints": {
        "Http": {
          "Url": "http://localhost:5000"
        },
        "Https": {
          "Url": "https://localhost:5001"
        }
      }
    }
    

  • 方式2：在Program.cs中硬编码配置（适用于.NET 6+极简模式）

    var builder = WebApplication.CreateBuilder(args);
    
    builder.WebHost.ConfigureKestrel(serverOptions =>
    {
        serverOptions.ListenLocalhost(5000); // 监听HTTP 5000端口
        serverOptions.ListenLocalhost(5001, opts => opts.UseHttps()); // 监听HTTPS 5001端口
    });
    
    // 注册控制器服务
    builder.Services.AddControllers();
    
    var app = builder.Build();
    
    // 启用HTTPS重定向（需放在路由配置之前）
    app.UseHttpsRedirection();
    
    app.MapControllers();
    
    app.Run();
    

• 修复本地HTTPS证书问题
  本地发布时默认开发证书可能未被系统信任，执行以下命令重置并信任证书：

  # 清除旧的无效证书（可选）
  dotnet dev-certs https --clean
  # 生成并信任新的开发证书
  dotnet dev-certs https --trust
  

• 匹配重定向端口配置
  如果在appsettings.json中单独配置了HttpsRedirection，必须保证端口与Kestrel监听的HTTPS端口一致：

  "HttpsRedirection": {
    "HttpsPort": 5001
  }
  

  若已通过Kestrel配置了HTTPS端点，该配置可省略，框架会自动识别监听端口。

• 验证端口监听状态
  启动应用后检查5001端口是否被正确监听：

  • Windows：命令行执行 netstat -ano | findstr :5001
  • Linux/macOS：执行 lsof -i :5001
    若未查到相关进程，说明Kestrel配置未生效，需检查代码或配置文件是否存在拼写错误。

总结 #

只要保证Kestrel同时监听HTTP/HTTPS端口、证书有效、重定向端口与监听端口一致，即可解决两种协议的访问问题。

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