Express操作MongoDB返回304状态码 报insertOne缓冲10s超时错误

你遇到的MongooseError: Operation users.insertOne() buffering timed out after 10000ms报错，本质是Mongoose尚未和MongoDB实例建立有效连接时，就收到了数据写入请求，操作在缓冲队列等待10秒后仍未等到可用连接，直接触发超时。你观察到的304状态码是客户端缓存的附带表现，核心故障点为数据库连接异常。

• 验证MongoDB服务运行状态
  本地部署的MongoDB直接在终端执行mongosh命令，能正常进入数据库交互Shell即代表服务运行正常；如果使用云MongoDB服务，先在服务商控制台确认实例处于正常运行状态，无欠费、暂停、封禁情况。
• 核对Mongoose连接配置
  检查项目中mongoose.connect()相关代码：
  1. 确认连接字符串格式正确：本地MongoDB默认连接串格式为mongodb://127.0.0.1:27017/你的业务库名，注意核对端口号、库名是否写错；云实例连接串要确认用户名、密码填写正确，密码含特殊字符时要做URL转义。
  2. 连接云MongoDB时，确认当前服务的出口IP已经加入实例的IP白名单，本地防火墙、云服务商安全组没有拦截27017端口的出站请求。
  3. 调整服务启动顺序：必须等Mongoose连接成功后，再注册路由、启动Express端口监听，避免请求进入时数据库连接还未建立。参考正确启动逻辑：

  const mongoose = require('mongoose');
  const express = require('express');
  const app = express();
  
  // 先建立数据库连接
  mongoose.connect('你的MongoDB连接串')
    .then(() => {
      console.log('MongoDB连接成功');
      // 连接成功后再注册路由、启动服务
      app.use('/api', require('./你的路由文件路径'));
      app.listen(3000, () => console.log('服务已启动在3000端口'));
    })
    .catch(err => console.error('数据库连接失败：', err));
  

• 检查User模型定义
  确认../models/User文件中的Schema定义、模型注册代码无语法错误，字段配置、集合名配置无冲突，不会导致Mongoose初始化模型失败。
• 临时验证配置
  如果确认网络连通仅存在较高延迟，可以调整连接参数临时验证问题，注意这不是根治方案：

  mongoose.connect('你的连接串', {
    bufferCommands: false, // 关闭命令缓冲，连接未就绪时直接抛错不等待
    serverSelectionTimeoutMS: 30000 // 拉长连接超时时间到30秒
  })
  

你当前的写入接口使用GET方法不符合REST规范，数据写入类接口应该使用POST方法；目前代码里写死了用户数据，后续对接前端请求时，需要补充参数合法性校验、密码加密存储逻辑，禁止明文存储密码。

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