根本原因是 mongoose.connect() 未 await 完成就执行 save()，导致操作进入缓冲队列超时；必须 await 连接、禁用 bufferCommands、主动 ping 验证并错误退出。
为什么 mongoose.save() 会报 buffering timed out
根本原因不是 MongoDB 挂了，而是 mongoose.connect() 还没完成，模型操作（比如 save()、find()）就已经执行了。Mongoose 会把这类操作塞进内部缓冲队列，等连接就绪；默认 10 秒超时，超时就抛 MongooseError: Operation 'xxx' buffering timed out after 10000ms。
connect() 必须 await，且不能写在模型文件里
常见错误是像这样写：
const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/test'); // ❌ 没 await，也没处理 Promise
const User = mongoose.model('User', schema);
module.exports = User;
这段代码一 require 就执行 connect，但调用方完全不知道它是否成功。正确做法是：
- 把
connect()封装成函数，导出供主入口调用 - 主入口（如
index.js）用await connectDb()确保连接完成后再加载/使用任何模型 - 所有模型定义文件（
user.model.js等）只定义 Schema 和 Model，不触发任何 DB 操作
禁用缓冲：bufferCommands: false 是刚需
即使连接逻辑写对了，网络抖动或临时断连仍可能让后续操作卡在缓冲队列里，导致接口假死。启用 bufferCommands: false 能让错误立刻暴露：
mongoose.connect('mongodb://localhost:27017/test', {
bufferCommands: false, // ⚠️ 关键：禁止缓冲命令
bufferMaxEntries: 0 // 配套设为 0，避免残留
});
这样一旦连接断开或未就绪，save() 会直接 reject，而不是默默等 10 秒再崩。
连接失败必须退出进程，不能静默吞掉
仅 try/catch connect() 不够，还要验证连接有效性：
- 用
await mongoose.connection.db.command({ ping: 1 })主动 ping 数据库 - 监听
mongoose.connection.on('error', ...)捕获运行时断连 - catch 到错误后必须
process.exit(1)，否则服务处于“半残”状态，后续请求全卡住
真正容易被忽略的是：Node.js 模块缓存不会共享连接状态。你在 connect-db.js 里连上了，不代表 get_user.js 里能复用——它们必须在同一个进程、同一轮事件循环中完成初始化。
