.Net Core API 项目运行时提示“Failed to connect to localhost/127.0.0.1:5000”，如何解决？

Question

在开发 .Net Core API 项目时，如果运行时遇到“Failed to connect to localhost/127.0.0.1:5000”的错误提示，可能是由于以下原因导致：一是项目配置文件“launchSettings.json”中服务器端口设置不正确或被占用；二是防火墙阻止了本地端口的访问；三是 Kestrel 服务器未正确启动或监听指定端口。 解决方法如下：首先检查“launchSettings.json”文件，确认“applicationUrl”字段是否包含正确的 URL 和端口号（如：http://localhost:5000）。其次，通过命令行执行“netstat -ano | findstr 5000”检查端口是否被占用，若被占用可更改配置中的端口。另外，临时关闭防火墙测试连接问题，或为应用添加防火墙规则。最后，确保项目能够正常启动 Kestrel 服务器，尝试使用“dotnet run”命令运行项目，观察控制台输出是否存在异常信息。完成上述步骤后重新运行项目，问题通常可以得到解决。

Answer 1

1. 问题概述

在开发 .Net Core API 项目时，运行过程中可能会遇到“Failed to connect to localhost/127.0.0.1:5000”的错误提示。这一问题可能由多种原因引起，包括配置文件设置错误、端口被占用、防火墙规则限制以及 Kestrel 服务器未正常启动等。

以下是可能导致该问题的常见原因：

• 项目配置文件“launchSettings.json”中服务器端口设置不正确或被占用。
• 防火墙阻止了本地端口的访问。
• Kestrel 服务器未正确启动或监听指定端口。

2. 检查与分析

为解决上述问题，我们需要从以下几个方面进行检查和分析：

1. 检查配置文件：确认“launchSettings.json”文件中的“applicationUrl”字段是否包含正确的 URL 和端口号（如：http://localhost:5000）。
2. 检查端口占用情况：通过命令行执行以下命令，检查端口是否被占用：netstat -ano | findstr 5000。
3. 测试防火墙影响：临时关闭防火墙以测试连接问题，或者为应用添加防火墙规则。
4. 验证 Kestrel 启动状态：使用dotnet run命令运行项目，并观察控制台输出是否存在异常信息。

3. 解决方案

根据问题的具体原因，可以采取以下解决方案：

问题原因	解决方法
配置文件端口设置错误	修改“launchSettings.json”文件中的“applicationUrl”字段，确保其包含正确的 URL 和端口号。
端口被占用	更改配置文件中的端口号，避免与其他服务冲突。
防火墙阻止访问	临时关闭防火墙或为应用添加防火墙规则。
Kestrel 服务器未启动	检查项目代码逻辑，确保 Kestrel 配置正确；使用dotnet run命令重新运行项目。

4. 实际操作步骤

以下是具体的排查和解决问题的操作步骤：

# 步骤1：检查端口占用情况
netstat -ano | findstr 5000

# 步骤2：修改配置文件
{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:5000",
      "sslPort": 0
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "YourProjectName": {
      "commandName": "Project",
      "launchBrowser": true,
      "applicationUrl": "http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

# 步骤3：运行项目并观察输出
dotnet run
    

5. 流程图

以下是解决问题的整体流程图：

graph TD;
            A[出现连接失败问题] --> B{检查配置文件};
            B --配置正确--> C{检查端口占用};
            C --端口未占用--> D{检查防火墙};
            D --无防火墙限制--> E{验证Kestrel启动};
            E --正常启动--> F[问题解决];
            B --配置错误--> G[修改配置文件];
            C --端口被占用--> H[更改端口号];
            D --有防火墙限制--> I[调整防火墙规则];
            E --未正常启动--> J[检查项目代码];