本地MongoDB服务器连接失败、mongosh命令无法识别问题求助

1. 修复mongosh命令无法识别问题 #

• 首先确认MongoDB安装目录下的bin文件夹完整路径：
  • Windows默认路径：C:\Program Files\MongoDB\Server\<你的版本号>\bin
  • macOS Homebrew安装路径：/usr/local/Cellar/mongodb-community/<你的版本号>/bin
  • Linux默认路径：/usr/bin 或 /usr/local/bin
• 将上述bin路径添加到系统环境变量PATH后，必须重启所有正在运行的终端/命令提示符窗口，旧窗口不会加载更新后的PATH配置
• 重启终端后执行验证命令：macOS/Linux运行echo $PATH，Windows运行echo %PATH%，确认bin路径已存在后，执行mongosh --version验证命令是否可用

2. 解决本地MongoDB连接被拒绝问题 #

报错中的Errno::ECONNREFUSED说明27017端口没有MongoDB服务在监听，你所说的"正常启动服务"大概率为假启动状态，按以下步骤排查：

• 第一步确认服务实际运行状态：
  • Windows：按下Win+R输入services.msc打开服务管理器，找到MongoDB Server <你的版本号>服务，确认状态为正在运行
  • macOS：终端执行brew services list，确认mongodb-community状态为started
  • Linux：终端执行sudo systemctl status mongod，确认状态为active (running)
• 第二步检查27017端口监听情况：
  • Windows执行netstat -ano | findstr 27017
  • macOS/Linux执行lsof -i :27017
  • 如果命令没有输出结果，说明服务虽显示启动但未成功绑定端口，需查看MongoDB运行日志排查错误，默认日志路径：
    • Windows：C:\Program Files\MongoDB\Server\<你的版本号>\log\mongod.log
    • macOS：/usr/local/var/log/mongodb/mongo.log
    • Linux：/var/log/mongodb/mongod.log
• 第三步检查MongoDB配置文件mongod.conf：确认net.bindIp配置为127.0.0.1或0.0.0.0，如果绑定了其他公网IP会导致本地无法通过localhost访问
• 以上配置修正后重启MongoDB服务，先执行mongosh mongodb://localhost:27017测试本地连接，连接成功后再启动Web项目验证数据库调用

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