MySQL pool.query返回异常信息而非查询结果，求排查原因

这种随机出现的异常确实挺闹心的，结合你提到的情况——调高连接池上限没用、账号权限正常，我梳理了几个大概率的原因，你可以逐一排查：

• 回调参数顺序搞混了
  如果你用的是mysql或mysql2的回调式调用，pool.query的回调参数是(err, results, fields)，其中fields就是你看到的查询元信息（字段描述、执行状态这些）。如果代码里不小心把fields当成results返回，就会出现这个问题。尤其是如果有异步分支逻辑，某个分支漏了正确处理参数，就会随机触发。比如：

  // 错误示例：误把fields当结果返回
  pool.query('SELECT * FROM users WHERE id = ?', [userId], (err, fields) => {
    if (err) throw err;
    res.send(fields); // 这里返回的是查询元信息，不是数据
  });
  

  正确的写法应该是拿到第二个参数results：

  pool.query('SELECT * FROM users WHERE id = ?', [userId], (err, results, fields) => {
    if (err) {
      // 错误处理逻辑
      return res.status(500).send(err.message);
    }
    res.send(results); // 这才是实际查询结果
  });
  

• 连接池复用了无效连接
  虽然你调高了connectionLimit，但MySQL服务器可能会主动关闭长时间空闲的连接，而连接池如果没及时检测到，复用这个失效连接时，查询的返回就会异常。可以给连接池加几个配置来优化：

  const pool = mysql.createPool({
    connectionLimit: 10,
    host: 'your-host',
    user: 'your-user',
    password: 'your-pass',
    database: 'your-db',
    idleTimeout: 30000, // 30秒空闲就关闭连接
    acquireTimeout: 60000, // 获取连接超时时间
    waitForConnections: true, // 没有可用连接时等待，而非直接拒绝
  });
  

  另外，可以在查询失败时捕获连接相关的错误，尝试重新发起查询，避免复用坏连接。

• 特定查询场景的结果误解
  有没有可能某些查询本身不会返回数据集？比如INSERT/UPDATE语句，results里是影响行数、插入ID这些元信息，如果你期望的是查询数据，但代码里不小心执行了写操作，就会拿到这类信息。还有一种情况是查询没有匹配到数据，results是空数组，如果你的代码没做判断，误把fields当成结果返回，也会出现类似问题。

• 依赖库版本的兼容性问题
  近期有没有更新过mysql/mysql2模块？不同版本的API可能有细微变化，比如mysql2的Promise模式返回结果结构是[results, fields]，如果用解构的时候顺序错了，也会拿到fields：

  // 错误示例：解构顺序反了
  const [fields, results] = await pool.query(sql);
  

  另外，某些版本可能存在随机返回元信息的bug，你可以尝试回退到之前稳定的版本，或者查看官方issue有没有类似问题。

• 并发请求下的变量污染
  如果你的路由逻辑里用了全局变量或者未正确隔离的共享变量，高并发场景下可能会出现变量被覆盖的情况。比如多个请求同时修改同一个变量，导致某个请求返回了另一个请求的fields信息。检查一下代码里有没有这类情况，确保每个请求的上下文是独立的。

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