.NET Core 7.0发布后HTTPS端口禁用原因及启用方法

1. launchsettings.json仅适用于开发环境：你提供的launchsettings.json里的HTTPS配置都是针对Development环境的，发布到Production环境时，这个文件不会被包含在发布包中，应用完全不会读取这里的配置。
2. Production环境默认行为：ASP.NET Core在Production环境下，若未明确配置HTTPS端点、证书等关键信息，会默认只监听HTTP的5000端口——开发环境的自签名证书是自动生成的，Production环境不会自动创建或加载这类证书，导致HTTPS端口被禁用。
3. 云端500错误：大概率是因为应用在云端运行时缺少HTTPS配置，导致请求重定向失败、证书加载异常，或是端口映射错误，触发内部服务器错误。

1. 配置Production环境的HTTPS端点 #

你需要明确指定Production环境下的监听地址，以下是几种常用方式：

方式一：通过appsettings.Production.json配置 #

在项目的appsettings.Production.json中添加Urls配置，指定HTTPS和HTTP端口：

{
  "Urls": "https://*:443;http://*:80"
}

（注：*表示监听所有IP，443/80是云端常用的标准端口，可根据实际需求调整）

方式二：通过环境变量配置 #

在云端托管平台或服务器中设置环境变量ASPNETCORE_URLS，值为https://*:443;http://*:80，这种方式无需修改代码，更灵活。

方式三：通过Kestrel代码配置（不推荐，灵活性差） #

在Program.cs中直接配置Kestrel端点：

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.ConfigureKestrel(options =>
{
    // 监听HTTP端口
    options.ListenAnyIP(80);
    // 监听HTTPS端口并启用HTTPS
    options.ListenAnyIP(443, opts => opts.UseHttps());
});

var app = builder.Build();

// 后续中间件配置...

app.Run();

2. 配置Production环境的HTTPS证书 #

Production环境必须使用可信证书，不能依赖开发环境的自签名证书：

• 云端平台（如Azure/AWS）：直接使用平台提供的托管SSL证书（比如Azure App Service的免费证书），无需手动配置证书文件，平台会自动完成证书绑定。
• 自建服务器：购买或生成可信证书后，通过以下方式配置：
  在appsettings.Production.json中添加证书路径和密码：

  {
    "Kestrel": {
      "Certificates": {
        "Default": {
          "Path": "/path/to/your/certificate.pfx",
          "Password": "your-certificate-password"
        }
      }
    }
  }
  

  或者通过环境变量ASPNETCORE_Kestrel__Certificates__Default__Path和ASPNETCORE_Kestrel__Certificates__Default__Password设置。

3. 排查云端500错误 #

• 优先查看云端应用的日志（如Azure日志流、AWS CloudWatch），日志会明确指出500错误的具体原因（比如证书加载失败、端口被占用、配置缺失等）。
• 确认云端托管平台的端口映射正确：将平台的HTTPS端口（通常是443）映射到应用配置的HTTPS端口。
• 确保ASPNETCORE_ENVIRONMENT环境变量已设置为Production，避免应用加载错误的配置文件。

4. 发布时的注意事项 #

• 在Visual Studio发布向导中，确认已正确配置目标环境的URL和HTTPS相关选项。
• 确保appsettings.Production.json被包含在发布包中（默认会包含，若手动修改过发布配置需检查）。

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