本地网络无法连接ASP.NET Core Swagger及Web API问题求助

• 配置Kestrel监听所有网络接口
  默认情况下Kestrel可能仅绑定localhost，需修改为监听所有IP：

  • 在Program.cs中添加Kestrel配置：

    var builder = WebApplication.CreateBuilder(args);
    // 其他服务配置...
    builder.WebHost.ConfigureKestrel(options =>
    {
        options.ListenAnyIP(5000); // 绑定所有IP的HTTP端口
        options.ListenAnyIP(5001, o => o.UseHttps()); // 绑定所有IP的HTTPS端口
    });
    var app = builder.Build();
    // 中间件配置...
    app.Run();
    

  • 或在appsettings.json中配置：

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

• 检查防火墙规则

  • 确保本机防火墙允许API使用的端口（如5000、5001）接收入站连接。Windows可在「Windows Defender防火墙→高级设置→入站规则」中新建TCP端口允许规则；Linux需通过ufw或iptables开放对应端口。

• 修正launchSettings.json配置
  确认profiles中的applicationUrl包含0.0.0.0或本机局域网IP，而非仅localhost：

  "profiles": {
    "http": {
      "commandName": "Project",
      "applicationUrl": "http://0.0.0.0:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "applicationUrl": "https://0.0.0.0:5001;http://0.0.0.0:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
  

• 验证局域网访问路径

  • 用ipconfig（Windows）或ifconfig（Linux）获取本机局域网IP，通过http://[局域网IP]:5000/api/xxx的格式访问API，而非localhost。
  • 确认访问设备与API所在机器处于同一局域网。

• 清理并重启项目
  运行dotnet clean清理项目，再用dotnet build重新编译，重启Visual Studio和项目确保配置生效。

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