Axios请求报错ECONNREFUSED，ping对应IP端口返回No route to host问题咨询

你遇到的request to http://MY_IP:9999/ failed, reason: connect ECONNREFUSED MY_IP:9999报错，本质是当前设备无法和目标IP的9999端口建立TCP连接，按照以下步骤逐一排查即可：

先修正基础测试命令 #

ping命令基于ICMP协议，不支持指定端口，ping MY_IP_ADDRESS:9999返回No route to host属于正常情况，检测端口连通性请用对应系统的命令：

• Windows：telnet MY_IP 9999
• Linux/macOS：nc -zv MY_IP 9999

如果返回连接成功，说明网络和端口没问题，问题出在服务配置或前端请求配置；如果连接失败，按以下步骤排查。

1. 确认后端服务正常启动 #

原项目依赖Docker运行整套服务，优先检查Docker相关状态：

• 先确认Docker服务本身运行正常：Windows/macOS打开Docker Desktop，确认左下角状态为运行中；Linux执行systemctl status docker，返回active即为正常。
• 进入项目根目录，执行docker ps -a查看所有容器列表：
  • 如果有项目相关的容器处于Exited状态，执行docker start <容器ID>启动对应容器
  • 如果没有找到相关容器，执行docker compose up -d启动整套服务（项目根目录一般会自带docker-compose.yml配置文件，已经预设好端口映射、数据库、后端服务的启动规则）
• 容器启动后执行docker logs <后端服务容器ID>查看启动日志，排查是否有端口占用、数据库连接失败、Prisma初始化失败等报错。

2. 确认网络和端口配置正确 #

• 先在运行服务的本机访问http://localhost:9999，如果本地无法访问，回到上一步排查服务启动问题。
• 如果本地可访问，其他设备无法访问：
  • 检查服务所在设备的防火墙是否开放9999端口：Linux可执行ufw allow 9999临时开放端口测试；如果是云服务器，还要登录云服务商后台在安全组规则中开放9999端口。
  • 确认当前调试设备和服务所在设备处于同一内网网段，填写的MY_IP为服务所在设备的正确内网/公网IP。
  • 临时关闭当前设备的系统代理、VPN后再测试，避免代理规则拦截内网请求。

3. 确认Prisma配置正确 #

• 进入项目的后端应用容器，执行npx prisma migrate deploy同步数据库表结构，避免表结构缺失导致服务启动失败。
• 检查项目根目录的.env文件中DATABASE_URL配置是否和Docker内的数据库服务匹配：如果配置里写的是localhost，需要改成docker-compose.yml中数据库对应的服务名，例如数据库服务命名为db的话，配置格式为mysql://用户名:密码@db:3306/数据库名。

4. 确认Axios请求配置正确 #

• 检查请求地址的IP、端口、路径是否和服务端一致，没有拼写错误。
• 如果是前端页面发起的请求，确认服务端已经配置CORS跨域规则，避免跨域拦截导致请求失败。

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