如何解决MongooseError: Operation `users.findOne()`缓冲超时10000ms问题？

问题原因 #

这个错误的核心是Express服务器在Mongoose完成数据库连接前就启动并处理请求。当Google OAuth回调触发Passport的用户查询逻辑时，Mongoose还未建立有效数据库连接，无法执行查询操作，最终触发超时。

看你的App.js代码，connectDB()是异步函数，但你直接调用后立刻创建Express实例并启动服务器，没有等待数据库连接完成的信号，导致回调请求到来时数据库还未就绪。

解决方案 #

1. 等待数据库连接成功后再启动服务器 #

修改App.js，将服务器启动逻辑包裹在异步流程中，确保数据库连接就绪后再处理请求：

const path = require('path')
const express = require('express')
const dotenv = require('dotenv')
const morgan = require('morgan')
const exphbs = require('express-handlebars')
const passport = require('passport')
const session = require('express-session')
const connectDB = require('./config/db')

// 加载配置文件
dotenv.config({ path: './config/config.env' })

// Passport配置
require('./config/passport')(passport)

// 用async函数包裹启动逻辑
const startServer = async () => {
  try {
    // 等待数据库连接完成
    await connectDB()
    
    const app = express()

    // 日志记录
    if (process.env.NODE_ENV === 'development') {
        app.use(morgan('dev'))
    }

    // Handlebars模板引擎
    app.engine('.hbs', exphbs.engine({ defaultLayout: 'main', extname: '.hbs' }))
    app.set('view engine', '.hbs')

    // Session配置
    app.use(session({
        secret: 'keyboard cat',
        resave: false,
        saveUninitialized: false
    }))

    // Passport中间件
    app.use(passport.initialize())
    app.use(passport.session())

    // 静态资源文件夹
    app.use(express.static(path.join(__dirname, 'public')))

    // 路由配置
    app.use('/', require('./routes/index'))
    app.use('/auth', require('./routes/auth'))

    const PORT = process.env.PORT || 3000

    app.listen(PORT, console.log(`Server running in ${process.env.NODE_ENV} mode on port ${PORT}`))
  } catch (err) {
    console.error('启动失败:', err)
    process.exit(1)
  }
}

// 启动服务器
startServer()

2. 优化Passport的deserializeUser逻辑（可选） #

虽然不是当前超时的直接原因，但将deserializeUser改为async/await写法可避免回调嵌套，保持代码风格一致：

passport.deserializeUser(async (id, done) => {
  try {
    const user = await User.findById(id)
    done(null, user)
  } catch (err) {
    done(err, null)
  }
})

额外检查项 #

• 确认process.env.MONGO_URI配置正确，能正常连接目标MongoDB实例（本地或云服务）
• 本地环境需检查MongoDB服务是否正常运行
• 云服务（如MongoDB Atlas）需确认IP白名单配置正确，网络可访问

内容的提问来源于stack exchange，提问作者Dion Esq.