NodeJS代码本地运行正常，他人电脑报users.findOne()缓冲超时错误

这个错误本质是Mongoose在等待数据库连接建立的过程中，查询缓冲超时了，结合你提到的根目录路径不同的情况，按以下方向排查解决：

• 数据库连接配置或状态异常
  本地能正常连接不代表朋友的环境没问题：

  • 如果用的是本地MongoDB，让朋友检查MongoDB服务是否启动；如果是远程MongoDB，确认连接字符串里的主机地址、用户名、密码、端口都正确，且网络能访问到目标数据库。
  • 代码里要确保数据库连接成功后再执行查询，比如把启动服务或查询逻辑放在连接成功的回调里：

    const mongoose = require('mongoose');
    mongoose.connect(process.env.MONGO_URI)
      .then(() => {
        console.log('数据库连接成功');
        // 在这里启动Express服务或执行users.findOne()查询
        app.listen(3000);
      })
      .catch(err => console.error('连接失败:', err));
    

• 环境变量加载失败（根目录路径导致）
  如果你用dotenv加载.env文件，相对路径会因为根目录不同失效：

  • 让朋友把.env文件放在项目入口文件（比如app.js/index.js）的同级目录；
  • 或者修改dotenv加载逻辑，用绝对路径确保能找到文件：

    const path = require('path');
    require('dotenv').config({ path: path.resolve(__dirname, '.env') });
    

• 依赖版本不一致
  本地和朋友的Mongoose/MongoDB驱动版本差异可能引发连接问题：

  • 把package-lock.json（或yarn.lock）一起分享给朋友，让他执行npm ci（而不是npm install）来安装完全一致的依赖版本。

• 调整Mongoose缓冲超时设置
  若朋友的网络或数据库启动较慢，可以延长缓冲超时时间：

  mongoose.connect(process.env.MONGO_URI, {
    bufferTimeoutMS: 30000 // 延长到30秒，默认是10秒
  });
  

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