Node.js中MySQL查询结果无法设为全局变量的问题求助

嘿，这个问题太常见啦，刚接触JavaScript异步机制的新手几乎都会碰到～本质原因是MySQL模块的query方法是异步操作，它不会阻塞代码的执行流程，咱们一点点拆解来看：

为什么会出现这个现象？ #

先模拟一下你大概的代码结构：

let results = [];
// 调用MySQL查询
connection.query('SELECT * FROM your_table', (err, res) => {
  if (err) throw err;
  results = res;
  console.log(results); // 第一个console.log，能正常输出结果
});
console.log(results); // 第二个console.log，先打印且是空数组

JavaScript是单线程的，代码会从上到下按顺序执行：

1. 先声明空数组results
2. 调用connection.query，这时候程序会发起数据库查询，但不会等着结果返回，而是直接跳去执行下一行代码
3. 执行第二个console.log，这时候数据库查询还没完成，results还是最初的空数组，所以打印空值
4. 等数据库返回查询结果后，才会执行query的回调函数，把results赋值为真实数据，然后执行第一个console.log

简单说就是：异步操作的结果还没出来，同步代码就已经跑完了。

怎么解决？ #

核心思路是：所有需要使用查询结果的逻辑，必须等异步操作完成后再执行，这里有两种常用的方式：

方式1：把逻辑放到回调函数里 #

这是最基础的写法，直接在query的回调里处理数据和写入HTML的逻辑：

connection.query('SELECT * FROM your_table', (err, res) => {
  if (err) {
    console.error('查询出错:', err);
    return;
  }
  // 这里拿到了真实的查询结果
  console.log(res);
  // 直接在这里写把数据写入HTML的逻辑
  renderDataToHTML(res);
});

// 专门处理HTML渲染的函数
function renderDataToHTML(data) {
  // 比如生成表格、插入DOM等操作
  const table = document.createElement('table');
  // 遍历data生成表格行...
  document.body.appendChild(table);
}

方式2：用Promise + Async/Await（推荐） #

这种写法更像“同步代码”，可读性更强，也是现在主流的异步处理方式：
首先把query封装成Promise：

// 封装一个返回Promise的查询函数
function queryDatabase(sql) {
  return new Promise((resolve, reject) => {
    connection.query(sql, (err, res) => {
      if (err) {
        reject(err); // 查询失败时抛出错误
      } else {
        resolve(res); // 查询成功时返回结果
      }
    });
  });
}

然后用async/await来调用这个函数：

// 必须在async函数里使用await
async function fetchDataAndRender() {
  try {
    // 这里会等待查询完成后再往下执行
    const results = await queryDatabase('SELECT * FROM your_table');
    console.log(results); // 拿到真实结果
    // 调用渲染HTML的函数
    renderDataToHTML(results);
  } catch (err) {
    console.error('数据库查询失败:', err);
  }
}

// 执行这个异步函数
fetchDataAndRender();

function renderDataToHTML(data) {
  // 你的HTML写入逻辑
}

小总结 #

JavaScript的异步机制是为了避免IO操作（比如数据库查询、网络请求）阻塞整个程序，记住一个核心原则：异步操作的结果，不能在异步函数外面的同步代码里直接获取，必须在异步操作完成后的回调、then方法或者await之后处理。

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