NodeJS中MariaDB Async Await始终返回undefined问题排查

核心原因是MariaDB官方npm连接器的conn.query默认是回调式API，你的getDBToken如果是async函数，但没有把回调逻辑包装成Promise，函数会在回调执行前就返回undefined——内部能打印结果是因为回调是异步触发的，和函数返回值无关。

解决方案一：将conn.query包装为Promise #

把回调逻辑包裹进Promise，让async函数能正确返回异步结果：

async function getDBToken(userId) {
  return new Promise((resolve, reject) => {
    conn.query(
      'SELECT token FROM tokens WHERE user_id = ?',
      [userId],
      (err, results) => {
        if (err) {
          reject(err);
          return;
        }
        console.log(results); // 正常打印查询结果
        resolve(results[0]?.token); // 返回目标令牌
      }
    );
  });
}

API端点调用时用await获取返回值：

// 示例Express端点
app.get('/api/token', async (req, res) => {
  try {
    const token = await getDBToken(req.query.userId);
    res.json({ token });
  } catch (err) {
    res.status(500).send('查询失败：' + err.message);
  }
});

解决方案二：直接使用连接器的Promise API #

MariaDB包本身支持Promise模式，无需手动包装，两种方式启用：

1. 导入promise版本的连接器

const mariadb = require('mariadb/promise');
// 创建连接池（推荐）或单个连接
const pool = mariadb.createPool({
  host: 'localhost',
  user: 'your_user',
  password: 'your_pwd',
  database: 'your_db'
});

2. 直接对query调用使用Promise语法

async function getDBToken(userId) {
  const results = await conn.query(
    'SELECT token FROM tokens WHERE user_id = ?',
    [userId]
  );
  console.log(results);
  return results[0]?.token;
}

为什么替换成简单async函数没问题？ #

你替换的简单async函数内部要么是同步逻辑，要么已经正确返回了Promise，函数能等待异步操作完成后返回结果；而原代码里的conn.query是回调异步，没有被Promise包裹，getDBToken会直接返回undefined，回调里的打印只是后续异步执行的副作用。

内容的提问来源于stack exchange，提问作者Flame Of Phoenix