如何解决Windows10下MongoDB Compass连接报错‘connect ECONNREFUSED 127.0.0.1:27017’

核心前提：你可能只装了Compass客户端，没装MongoDB服务器 #

Compass是可视化管理工具，本身无法提供数据库服务，必须搭配MongoDB服务器才能建立连接。很多新手会忽略这一点，先确认是否安装了服务器：

• 打开C:\Program Files目录，查看是否存在MongoDB\Server文件夹，没有则说明未安装服务器。

方案1：安装MongoDB服务器并自动注册服务 #

1. 下载MongoDB社区版（免费），安装时注意：
   • 选择「Complete」完整安装，或自定义安装路径
   • 勾选「Install MongoDB as a Service」选项，安装完成后服务会自动注册到Windows服务列表
2. 安装完成后，按Win+R输入services.msc打开Windows服务，找到「MongoDB」服务右键启动即可。

方案2：手动注册MongoDB服务（已装服务器但服务未注册） #

1. 找到MongoDB安装目录的bin文件夹，默认路径示例：C:\Program Files\MongoDB\Server\6.0\bin（替换为你的实际版本号）
2. 手动新建数据存储和日志目录：C:\data\db（存放数据库文件）、C:\data\log（存放日志文件）
3. 以管理员身份打开命令提示符（CMD），依次执行以下命令：
   • 切换到bin目录：

     cd "C:\Program Files\MongoDB\Server\6.0\bin"
     

   • 注册服务：

     mongod --install --serviceName "MongoDB" --serviceDisplayName "MongoDB" --dbpath "C:\data\db" --logpath "C:\data\log\mongodb.log"
     

   • 启动服务：

     net start MongoDB
     

4. 再次打开services.msc，就能看到MongoDB服务了。

方案3：临时启动MongoDB服务器（无需注册服务） #

如果只是临时测试，不想注册服务，可直接启动服务器：

1. 打开CMD并切换到MongoDB的bin目录
2. 执行命令：

   mongod --dbpath "C:\data\db"
   

3. 保持CMD窗口打开，服务器会在前台运行，此时用Compass连接mongodb://localhost:27017即可。关闭CMD窗口服务器会停止。

额外排查：检查端口27017是否被占用 #

若以上操作后仍报错，可能是端口被其他进程占用：

1. 打开CMD，执行命令：

   netstat -ano | findstr :27017
   

2. 如果返回结果，记录对应的PID，打开任务管理器（Ctrl+Shift+Esc），通过PID找到并结束占用端口的进程，再重新启动MongoDB服务。

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