调试ASP.NET Core 7 Web API时端口绑定失败的原因排查

问题现象 #

调试ASP.NET Core 7 Web API应用时，频繁在Program.cs的app.Run()行触发错误：

Failed to bind to address - An attempt was made to access a socket in a way forbidden by its access permissions

涉事端口为44399。

临时缓解方法 #

以下操作可临时解决该问题：

• 关闭当前Visual Studio 2022实例
• 关闭所有Visual Studio实例
• 关闭Visual Studio内所有活动窗口
• 重启电脑

端口占用排查命令 #

可通过以下PowerShell命令查看44399端口的占用进程：

$processes = (Get-NetTCPConnection | ? {($_.State -eq "Listen") -and ($_.LocalPort -eq "44399")
    }) | select OwningProcess, LocalPort
foreach ($process in $processes) {
    Get-Process -PID $process.OwningProcess | select ID,ProcessName, @{Name='LocalPort'; Expression={$process.LocalPort}}
}

关键现象细节 #

• 出现错误时，44399端口被系统占用，关闭所有VS实例可释放该端口
• 启动调试器时会直接获取并锁定端口；先以非调试模式启动进程再附加调试可成功一次，但之后端口会再次被锁定，必须重启VS才能再次使用
• 切换应用端口可规避当前错误，但启动调试时旧端口44399仍会被系统锁定

项目launchSettings.json配置 #

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:59999",
      "sslPort": 44398
    }
  },
  //profile can be selected with the start debug button in the toolbar
  "profiles": {
    "Proj.Web-Dev": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "swagger",
      "applicationUrl": "https://localhost:44398;http://localhost:59999",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "hotReloadEnabled": true
    },
    "Proj.Web-QA": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "launchUrl": "swagger",
      "applicationUrl": "https://localhost:44398;http://localhost:59999",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "QA"
      },
      "hotReloadEnabled": true
    },
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "swagger",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

根本原因分析 #

1. VS调试进程残留：Visual Studio调试ASP.NET Core应用时，会启动dotnet.exe、IIS Express辅助进程等关联进程，若调试会话异常终止（如强制停止、热重载失败），部分进程可能未被VS正确回收，导致44399端口被残留进程占用。关闭所有VS实例能释放端口，说明占用进程属于VS调试链路的一部分。

2. 调试器与Kestrel的端口冲突：从配置看，项目指定的SSL端口为44398，但错误出现在44399，推测是VS调试器自动分配了辅助端口（用于诊断、热重载通信等），但该端口的锁定逻辑与Kestrel的端口绑定机制存在冲突，导致后续调试会话无法重新绑定该端口。

3. 热重载功能的端口泄漏：配置中开启了hotReloadEnabled: true，热重载依赖额外的通信端口实现代码更新，若热重载过程中出现异常，可能导致相关端口未正确释放，44399端口被持续锁定。

4. 临时权限异常：虽然关闭VS即可释放端口，但不排除当前用户对44399端口的绑定权限出现临时异常，不过结合现象来看，进程残留是最核心的诱因。

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