ECONNREFUSED 127.0.0.1:3000 表明服务未运行、未监听该地址、端口被占用、防火墙拦截、hosts解析异常，或在Android模拟器/Docker/WSL2等环境中误用127.0.0.1。

如果您尝试访问本地运行的开发服务，但收到 ECONNREFUSED 127.0.0.1:3000 错误，则表明客户端无法与目标端口建立 TCP 连接。以下是解决此问题的步骤：

一、确认后端服务是否已启动并监听正确地址

该错误最常见原因是目标服务未运行，或虽运行但未绑定到 127.0.0.1:3000。服务可能处于崩溃、未启动、监听其他端口或仅监听 IPv6 地址的状态。

1、在终端中执行 netstat -an | grep :3000（Linux/macOS）或 netstat -ano | findstr :3000（Windows），检查是否有进程监听 3000 端口。

2、若无输出，说明服务未监听该端口；此时需手动启动服务，例如执行 npm start 或 yarn dev。

3、若服务已启动但仅显示监听 :::3000（IPv6）而非 127.0.0.1:3000，需修改服务配置，强制绑定 IPv4 地址，如 Express 中使用 app.listen(3000, '127.0.0.1')。

二、检查端口是否被其他进程占用

即使服务看似未运行，3000 端口也可能被残留进程、IDE 插件、Docker 容器或其他调试工具独占，导致新服务无法绑定。

1、在 Linux/macOS 上执行 lsof -i :3000，查看占用进程 PID。

2、在 Windows 上执行 netstat -ano | findstr :3000，记录 PID 后使用 tasklist | findstr "PID" 查看进程名。

3、确认非必要进程后，执行 kill -9 PID（Linux/macOS）或 taskkill /PID PID /F（Windows）释放端口。

三、验证防火墙或安全软件拦截

某些系统级防火墙或第三方安全软件会主动拒绝本地环回连接，尤其在企业环境或启用了高级防护策略时。

1、临时禁用系统防火墙：macOS 执行 sudo pfctl -d；Windows 在“Windows Defender 防火墙”中选择“启用或关闭防火墙”并设为关闭。

2、检查第三方安全软件（如 360、腾讯电脑管家、McAfee）是否启用“网络连接监控”或“环回连接拦截”，将其规则临时设为允许。

3、重启服务并重试请求，确认是否恢复连接。

四、排查 hosts 文件与 DNS 解析干扰

尽管目标是 127.0.0.1，但部分框架或代理层可能通过域名解析间接触发 hosts 映射异常，导致实际连接地址偏移。

1、打开系统 hosts 文件：/etc/hosts（macOS/Linux）或 C:\Windows\System32\drivers\etc\hosts（Windows）。

2、查找是否存在对 localhost 或自定义开发域名（如 dev.local）指向非 127.0.0.1 的条目，例如 192.168.1.100 localhost。

3、将异常行注释（在行首加 #），保存文件，然后执行 ping localhost 确认返回 IP 是否为 127.0.0.1。

五、Android 模拟器或容器环境中的特殊处理

在 Android 模拟器、Docker 容器或 WSL2 等隔离环境中，127.0.0.1 不指向宿主机，而是指向当前容器或模拟器自身，因此无法访问宿主机上运行的服务。

1、Android 模拟器中，将请求地址中的 127.0.0.1 替换为 10.0.2.2（模拟器专用网关地址）。

2、Docker 容器内访问宿主机服务时，Linux 主机使用 host.docker.internal，macOS/Windows Docker Desktop 默认支持该域名；Linux 需添加 --add-host=host.docker.internal:host-gateway 参数启动容器。

3、WSL2 中访问 Windows 宿主机服务，应使用 $(cat /etc/resolv.conf | grep nameserver | awk '{print $2}') 获取 Windows 主机 IP，而非 127.0.0.1。