WSL2环境下Node.js应用无法连接Windows本地MongoDB的求助
问题场景
- 开发基于Mongoose调用MongoDB的Node.js应用,启动服务时触发数据库连接异常
- 环境配置:MongoDB直接部署在本地Windows系统,Node.js运行环境、NPM全部部署在WSL2(使用Pengwin发行版,刚从WSL1升级至WSL2)
- 可正常从Windows浏览器访问运行在WSL2中的应用,但始终无法连通Windows侧的MongoDB服务
现有数据库连接代码
module.exports = (async () => { const mongoose = require('mongoose'); try { await mongoose.connect('mongodb://172.28.86.172:27017/mydb', { useNewUrlParser: true, useUnifiedTopology: true, useFindAndModify: false, useCreateIndex: true }); } catch (error) { console.log(error); } })();
运行报错信息
执行连接逻辑后抛出连接拒绝错误:
MongooseServerSelectionError: connect ECONNREFUSED 172.28.86.172:27017 at NativeConnection.Connection.openUri (/home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/connection.js:845:32) at /home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/index.js:345:10 at /home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/helpers/promiseOrCallback.js:31:5 at new Promise (<anonymous>) at promiseOrCallback (/home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/helpers/promiseOrCallback.js:30:10) at Mongoose._promiseOrCallback (/home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/index.js:1135:10) at Mongoose.connect (/home/alberttocastro/Dev/solutis/solucao-chamados/node_modules/mongoose/lib/index.js:344:20) at /home/alberttocastro/Dev/solutis/solucao-chamados/src/app/persistence.js:6:20 at Object.<anonymous> (/home/alberttocastro/Dev/solutis/solucao-chamados/src/app/persistence.js:15:3) at Module._compile (internal/modules/cjs/loader.js:1063:30) at Object.Module._extensions..js (internal/modules/cjs/loader.js:1092:10) at Module.load (internal/modules/cjs/loader.js:928:32) at Function.Module._load (internal/modules/cjs/loader.js:769:14) at Module.require (internal/modules/cjs/loader.js:952:19) at require (internal/modules/cjs/helpers.js:18:18) at /home/alberttocastro/Dev/solutis/solucao-chamados/src/server.js:6:9 { reason: TopologyDescription { type: 'Unknown', setName: null, maxSetVersion: null, maxElectionId: null, servers: Map(1) { '172.28.86.172:27017' => [ServerDescription] }, stale: false, compatible: true, compatibilityError: null, logicalSessionTimeoutMinutes: null, heartbeatFrequencyMS: 10000, localThresholdMS: 15, commonWireVersion: null } }
端口排查结果
- WSL2环境内执行
netstat,未查询到27017端口的监听或连通记录 - Windows PowerShell内执行
netstat,确认MongoDB服务处于运行状态,但仅绑定在127.0.0.1:27017回环地址,未对外开放:
Conexões ativas Proto Endereço local Endereço externo Estado TCP 127.0.0.1:27017 #############:50798 ESTABLISHED TCP 127.0.0.1:27017 #############:50799 ESTABLISHED TCP 127.0.0.1:27017 #############:50800 ESTABLISHED TCP 127.0.0.1:27017 #############:50801 ESTABLISHED TCP 127.0.0.1:27017 #############:50802 ESTABLISHED TCP 127.0.0.1:27017 #############:50803 ESTABLISHED TCP 127.0.0.1:27017 #############:50804 ESTABLISHED TCP 127.0.0.1:27017 #############:50805 ESTABLISHED TCP 127.0.0.1:27017 #############:50806 ESTABLISHED TCP 127.0.0.1:27017 #############:50807 ESTABLISHED TCP 127.0.0.1:27017 #############:51199 ESTABLISHED
可落地解决操作步骤
1. 修改MongoDB监听绑定地址
MongoDB默认仅绑定回环地址,无法接收来自WSL2网段的请求,需调整配置:
- 打开MongoDB配置文件,路径通常为
C:\Program Files\MongoDB\Server\<对应版本号>\bin\mongod.cfg - 定位到
net配置段,将bindIp参数值从127.0.0.1修改为0.0.0.0,即绑定所有网卡地址 - 保存配置文件,在Windows服务管理器中找到MongoDB服务执行重启操作
2. 配置Windows防火墙入站规则
允许WSL2网段的请求访问27017端口:
- 打开Windows Defender防火墙高级设置面板
- 新建入站规则,选择“端口”规则类型
- 选择TCP协议,指定本地端口为27017
- 规则动作设置为“允许连接”
- 规则应用到所有网络配置文件,命名为“允许WSL2访问MongoDB”后保存
3. 调整连接串地址
WSL2环境中Windows主机的IP会在每次重启WSL2后动态变化,无需固定写死IP地址,可通过以下方式获取正确地址:
- 在WSL2终端执行
cat /etc/resolv.conf | grep nameserver,获取当前Windows主机对应的动态IP - 将连接串中的IP替换为上述获取到的地址即可
Windows 11 22H2及以上版本的WSL2已支持回环自动映射,可直接使用
mongodb://localhost:27017/mydb作为连接串,无需手动查询IP。
内容的提问来源于stack exchange,提问作者AlberttoCastro
相关产品推荐
相关产品推荐

