You need to enable JavaScript to run this app. WSL2环境下Node.js应用无法连接Windows本地MongoDB的求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 11:15:06