ASP.NET Core 8.0 Web API部署IIS后端口绑定失败求助

问题根源 #

ASP.NET Core应用部署到IIS时，IIS作为反向代理，会通过ASP.NET Core Module将请求转发给Kestrel。如果代码里硬编码了Kestrel绑定5000端口，就会和其他占用该端口的服务冲突，同时忽略IIS配置的7090端口。

解决方案 #

1. 修改Program.cs，移除硬编码的Kestrel端口配置 #

检查你的Program.cs，确保没有手动指定绑定5000端口的代码，让应用自动适配IIS提供的端口。

错误示例（可能导致问题的代码）：

var builder = WebApplication.CreateBuilder(args);
// 硬编码绑定5000端口，会强制忽略IIS配置
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.ListenAnyIP(5000);
});

正确写法：

移除硬编码的Kestrel端口配置，保留基础服务和中间件配置即可：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

如果需要保留Kestrel自定义配置，同时兼容IIS，需启用IIS集成：

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.UseIISIntegration(); // 启用IIS集成，自动适配IIS端口

builder.Services.AddControllers();

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

2. 检查配置文件中的Kestrel设置 #

打开appsettings.json，如果存在指定5000端口的配置，直接删除或修改：

// 需移除的错误配置
"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://*:5000"
    }
  }
}

3. 验证IIS基础配置 #

• 确认IIS站点绑定的端口为7090，且该端口未被其他进程占用
• 检查服务器已安装ASP.NET Core Runtime和ASP.NET Core Module（部署必备组件）
• 将应用程序池的.NET CLR版本设置为无托管代码（ASP.NET Core为自托管模式）

事件查看器错误日志对应处理 #

如果事件查看器显示类似Failed to bind to address http://[::]:5000: address already in use的错误，直接对应上述端口冲突问题，按前面的步骤修改代码即可解决。

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