VS Code执行dotnet run启动ASP.NET Core WebApi遇Socket Exception(10049)如何解决？

云原生阿岚

2026-8-22

解决ASP.NET Core WebApi启动时SocketException(10049)异常的方案

错误码10049的核心原因是Kestrel服务器尝试绑定的IP地址在当前环境中无效，可能是配置了不存在的本机IP、地址格式错误，或是端口配置异常。以下是具体解决步骤：

检查配置文件中的地址设置
打开appsettings.json或appsettings.Development.json，定位Kestrel节点下的Endpoints配置，确保绑定的IP是本机有效地址（如127.0.0.1、0.0.0.0或本机实际IPv4地址），且端口未被占用。示例正确配置：
```
"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://127.0.0.1:5000"
    }
  }
}
```
若在Program.cs中直接配置Kestrel，检查代码中的绑定逻辑：
```
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.ListenLocalhost(5000); // 或使用ListenAnyIP(5000)监听所有地址
});
```
临时指定启动地址运行
执行命令时直接指定有效地址，覆盖配置文件设置：
```
dotnet run --urls "http://127.0.0.1:5000;https://127.0.0.1:5001"
```
验证本机可用IP
打开命令提示符执行ipconfig，查看本机实际IPv4地址列表，确保配置的IP在列表内，避免使用不存在的地址。
确认端口未被占用
若怀疑端口被占用，执行以下命令查看端口占用情况：
```
netstat -ano | findstr :5000
```
若有结果，根据PID结束对应进程后重新启动项目。