为何localhost:27017连接MongoDB会触发Mongoose缓冲超时错误？

出现这个差异的核心是localhost的地址解析逻辑和MongoDB的监听配置不匹配：

• localhost在系统hosts文件中通常同时映射了IPv4的127.0.0.1和IPv6的::1，系统会按优先级尝试解析。如果MongoDB服务只监听了IPv4的127.0.0.1（默认配置），当系统优先用IPv6地址::1尝试连接时，就会失败，最终触发Mongoose的缓冲超时错误。
• 直接使用127.0.0.1会强制走IPv4协议，匹配MongoDB的默认监听地址，因此能成功建立连接。

1. 查看hosts文件：
   • Windows路径：C:\Windows\System32\drivers\etc\hosts
   • Linux/macOS路径：/etc/hosts
     检查是否存在两行类似配置：

   127.0.0.1       localhost
   ::1             localhost
   

2. 检查MongoDB监听地址：
   • Windows执行命令：netstat -ano | findstr :27017
   • Linux/macOS执行命令：lsof -i :27017
     查看输出是否只有127.0.0.1:27017，没有::1:27017。

你可以根据情况选择以下任意一种方案：

• 方案1：修改MongoDB监听配置
  编辑MongoDB的配置文件（如mongod.conf），将net.bindIp设置为同时监听IPv4和IPv6：

  net:
    bindIp: 127.0.0.1,::1
  

  保存后重启MongoDB服务，这样localhost解析到IPv6也能正常连接。
• 方案2：调整hosts文件解析优先级
  在hosts文件中，把127.0.0.1 localhost放在::1 localhost的前面，让系统优先将localhost解析为IPv4地址。
• 方案3：代码中直接使用127.0.0.1
  保持你现在的做法，直接指定IPv4地址，避免解析歧义。

原代码没有捕获连接和保存过程中的错误，建议添加错误处理逻辑，方便排查问题：

const mongoose = require("mongoose");

// 连接数据库并捕获连接错误
mongoose.connect("mongodb://localhost:27017/fruitsDB", { useNewUrlParser: true })
  .then(() => console.log("数据库连接成功"))
  .catch(err => console.error("数据库连接失败:", err));

const Cat = mongoose.model('Cat', { name: String });

const kitty = new Cat({ name: 'Zildjian' });

// 保存文档并捕获保存错误
kitty.save()
  .then(() => console.log('meow'))
  .catch(err => console.error("文档保存失败:", err));

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