Node.js中如何将MongoDB findOne查询结果保存到JS变量供后续使用

你遇到的是Node.js异步IO的典型问题：MongoDB的findOne方法是异步执行的，回调函数的执行时机晚于主线程的同步代码执行，所以你无法在同步上下文里直接拿到异步返回的结果。你之前的两种写法都不符合异步逻辑的执行规则，才会返回undefined。

方案1：使用async/await（最推荐，写法最简洁） #

Node.js 14.8及以上版本支持顶层await，可以直接在文件顶层写异步等待逻辑：

const userCredential = require("./db").db().collection("api");
// 等待异步查询完成后再赋值
const adminDoc = await userCredential.findOne({username: 'admin'});
const api = adminDoc.api;

// 后续代码可以直接调用api变量

如果你的Node版本不支持顶层await，可以用自执行异步函数包裹所有依赖api变量的业务逻辑：

const userCredential = require("./db").db().collection("api");
let api;

(async function init() {
  const adminDoc = await userCredential.findOne({username: 'admin'});
  api = adminDoc.api;
  // 所有需要用到api的业务逻辑都放在这里执行，或者在这里调用依赖api的函数
  runBusiness();
})()

注意：不要在自执行函数外的同步上下文调用api变量，这时候查询还没完成，值还是undefined

方案2：回调内执行逻辑 #

如果你坚持使用回调写法，所有依赖api的代码必须放在回调函数内部执行：

const userCredential = require("./db").db().collection("api");
userCredential.findOne({username:'admin'}, (err, doc)=> {
  if (err) {
    // 处理查询错误
    console.error('查询失败', err);
    return
  }
  const api = doc.api;
  // 所有需要用到api的逻辑都写在这里
  console.log(api);
})

建议给异步查询加上错误处理，避免查询失败或文档不存在时后续代码报错：

try {
  const adminDoc = await userCredential.findOne({username: 'admin'});
  if (!adminDoc) {
    throw new Error('未找到admin对应的API配置文档')
  }
  const api = adminDoc.api;
} catch (e) {
  console.error('初始化API配置失败：', e);
  // 可以在这里加降级逻辑，比如使用默认配置、终止进程等
}

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