econnrefused 错误本质是目标主机主动拒绝tcp连接，常见于mongodb未监听指定地址端口；需确认mongod进程运行、端口开放、ipv4/ipv6匹配（建议用127.0.0.1或{family:4}）、bindip配置正确，并排查端口占用与数据目录权限。
ECONNREFUSED 错误本质是 TCP 连接被目标主机主动拒绝，不是超时也不是 DNS 失败 —— 说明你的 Node.js 进程确实发出了连接请求，但 MongoDB 没在对应地址和端口上监听。
确认 mongod 进程是否真正运行
这是最常被跳过的一步。即使你执行过 mongod，也可能因权限、配置或前台退出而实际未生效。
- 运行
ps aux | grep mongod（macOS/Linux）或tasklist | findstr mongod（Windows），确认有mongod进程存在，且不是刚启动又崩溃的“僵尸”进程 - 检查默认数据目录是否可写：
/usr/local/var/mongodb（macOS Homebrew）、C:\data\db（Windows 默认），若目录不存在或无权限，mongod会静默失败 - 不要只依赖
mongoshell 能连就认为服务正常 —— 它可能复用已有 socket 或走不同路径；直接用telnet 127.0.0.1 27017或nc -zv 127.0.0.1 27017测试端口是否真实开放
区分 IPv4 和 IPv6 地址解析问题
Node.js v17+ 默认启用 IPv6 解析，而 localhost 在 /etc/hosts 中常同时映射到 ::1 和 127.0.0.1，但 MongoDB 若只监听 IPv4（默认行为），就会拒绝来自 ::1 的连接请求，报错中出现 ::1:27017 就是明确信号。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 最简修复：把连接字符串里的
localhost换成127.0.0.1，例如mongodb://127.0.0.1:27017/mydb - 更稳妥方案：在
MongoClient构造选项中显式指定{ family: 4 }，强制走 IPv4 - 不推荐降级 Node.js 版本 —— 这只是掩盖问题，且会带来其他兼容性风险
检查 MongoDB 的 bindIp 配置
即使 mongod 在跑，如果它监听的 IP 不包含你尝试连接的那个，照样 ECONNREFUSED。
- 查看当前配置：运行
mongod --version后，检查是否用了配置文件（如/usr/local/etc/mongod.conf），重点看net.bindIp字段 - 常见错误值：
127.0.0.1（仅本地 IPv4）、::1（仅本地 IPv6）、localhost（依赖 hosts 解析，不可靠） - 开发环境安全做法：设为
127.0.0.1,::1，既支持双栈又不暴露外网；生产环境绝不能设为0.0.0.0或省略该字段
警惕残留进程与端口占用
多个 mongod 实例或其它服务（如 Docker 容器、另一个 Node 服务）可能已占住 27017 端口，新实例启动失败却没报错。
- 用
lsof -i :27017（macOS/Linux）或netstat -ano | findstr :27017（Windows）查端口持有者 PID - 注意：有些 MongoDB 安装（如 MongoDB Compass 自带的临时服务）会悄悄启动并占用端口，关掉 GUI 工具后未必自动释放
- 若发现非 mongod 进程占端口，用
kill -9 <pid></pid>或任务管理器结束，再重试mongod
真正麻烦的不是错误本身，而是它掩盖了底层状态 —— mongod 是否真在监听、监听在哪、是否被其它进程劫持端口。每次遇到 ECONNREFUSED，先别改代码，花 30 秒查进程、查端口、查 bindIp，90% 的情况当场解决。
