MongooseError: users.findOne()缓冲超时问题求助

我开发电影网站登录功能时，用Insomnia发送POST注册请求触发了如下错误：

MongooseError: Operation users.findOne() buffering timed out after 10000ms

试过多种方法未解决，附上AuthController代码：

import userModel from "../model/userModel.js";

export default class AuthController{
  static async sendToken(user, statusCode, res){
    const token = user.getSignedToken(res);
    res.status(statusCode).json({
        "success": true,
        "token",
    });
  }

  static async registerController(req, res, next) {
    try {
      const { username, email, password } = req.body;
      const exisitingEmail = await userModel.findOne({ email });
      if (exisitingEmail) {
        return next(new errorResponse("Email is already register", 500));
      }
      const user = await userModel.create({ username, email, password });
      this.sendToken(user, 201, res);
    } catch (error) {
      console.log(error);
      next(error);
    }
  }

  static async loginController(req, res, next){
    try {
      const { username, password } = req.body;
      if (!username || !password) {
        return next(new errorResponse("Please provide email or password"));
      }
      const user = await userModel.findOne({ username });
      if (!user) {
        return next(new errorResponse("Invalid Creditial", 401));
      }
      const isMatch = await user.matchPassword(password);
      if (!isMatch) {
        return next(new errorResponse("Invalid Creditial", 401));
      }
      this.sendToken(user, 200, res);
    } catch (error) {
      console.log(error);
      next(error);
    }
  }

  static async logoutController(req, res, ){
    res.clearCookie('refreshToken');
    return res.status(200).json({
        "success":true,
        "message":"Logout Successfully",
    });
  }
}

排查方向及解决步骤 #

1. 确认Mongoose已成功连接MongoDB #

这是该错误最常见的诱因。检查数据库连接逻辑，必须确保在执行任何数据库操作前，连接已建立完成。

示例连接代码：

import mongoose from 'mongoose';

const connectDB = async () => {
  try {
    await mongoose.connect(process.env.MONGO_URI);
    console.log('MongoDB 连接成功');
  } catch (err) {
    console.error('MongoDB 连接失败:', err);
    process.exit(1);
  }
};

export default connectDB;

启动服务器时，要先调用连接函数，再初始化Express服务：

import connectDB from './config/db.js';
connectDB(); // 优先连接数据库

const app = express();
// 中间件、路由注册等逻辑
app.listen(3000, () => console.log('服务器启动在端口3000'));

2. 检查数据库连接字符串正确性 #

核对process.env.MONGO_URI的内容：

• 云服务（如MongoDB Atlas）需确认用户名、密码、集群地址、数据库名称无拼写错误
• 特殊字符需正确转义
• 本地MongoDB需确认地址为mongodb://localhost:27017/你的数据库名

3. 网络/访问权限检查 #

• 若使用MongoDB Atlas，需在控制台将当前IP加入白名单，允许外部访问
• 本地环境需确认MongoDB服务正在运行，端口27017未被占用

4. 模型定义验证 #

检查userModel的集合名称是否与数据库中一致，避免Mongoose自动复数化导致的集合不匹配：

// userModel.js示例
const userSchema = new mongoose.Schema(
  {
    username: String,
    email: String,
    password: String
  },
  { collection: 'users' } // 显式指定集合名，避免自动复数
);

export default mongoose.model('User', userSchema);

5. 额外调试手段 #

添加Mongoose连接状态监听，实时排查连接问题：

mongoose.connection.on('connected', () => console.log('Mongoose 已建立连接'));
mongoose.connection.on('error', err => console.error('Mongoose 连接错误:', err));
mongoose.connection.on('disconnected', () => console.log('Mongoose 连接断开'));

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