Node.js连接Android应用报错：TypeError: Cannot read property 'length' of undefined

嘿，这个错误我之前帮好几个开发者踩过坑——本质就是你在尝试访问一个undefined变量的length属性，而这个变量正是你预期从MySQL返回的rows。咱们一步步拆解可能的原因和解决办法：

1. 没处理MySQL查询的错误回调 #

这是最常见的原因！当你用MySQL客户端执行查询时，回调函数的第一个参数是error，第二个才是结果rows。如果查询过程中出错（比如SQL语法错误、数据库权限不足、表名拼写错），error会有值，而rows会是undefined，这时候直接访问rows.length就会触发那个TypeError。

解决办法：先判断错误是否存在，再处理结果：

const mysql = require('mysql');
const connection = mysql.createConnection(/* 你的连接配置 */);

connection.query('SELECT * FROM your_target_table', (error, rows) => {
  // 先检查错误
  if (error) {
    console.error('MySQL查询出错:', error.message);
    return; // 出错就终止后续逻辑
  }
  // 这里再安全地使用rows
  console.log('返回数据行数:', rows.length);
});

另外，就算查询没返回任何数据，rows也会是一个空数组（[]），length为0，不会是undefined——所以只要出现这个错误，大概率是查询过程本身出问题了。

2. 数据库连接根本没建立成功 #

如果你的Node.js程序连MySQL服务器都没连上，那执行查询自然拿不到任何结果，rows肯定是undefined。

排查&解决：

• 先检查连接配置：主机地址、端口、用户名、密码、数据库名是不是都正确，有没有把localhost写成localhsot这种低级错误；
• 确认MySQL服务是否在运行，防火墙有没有开放3306端口；
• 给连接加个成功/失败的回调，验证连接状态：

connection.connect((err) => {
  if (err) {
    console.error('数据库连接失败:', err);
    return;
  }
  console.log('✅ 成功连接到MySQL服务器');
});

3. MySQL客户端API用法错误 #

不同的MySQL库（比如mysql、mysql2、sequelize）返回结果的结构可能不一样。比如用mysql2的Promise模式时，查询返回的是一个包含rows和fields的数组，如果你直接把整个结果赋值给rows，那它的结构就不是你预期的数组：

错误写法：

// mysql2 Promise模式下的错误示例
async function fetchData() {
  const rows = await connection.query('SELECT * FROM your_table');
  console.log(rows.length); // 这里的rows其实是[真实rows数组, fields对象]，所以length是2，但你要的是rows[0].length
}

正确写法：

async function fetchData() {
  try {
    const [rows] = await connection.query('SELECT * FROM your_table');
    console.log('返回行数:', rows.length);
  } catch (err) {
    console.error('查询出错:', err);
  }
}

建议你去核对一下当前使用的MySQL库的官方文档，确认查询结果的结构。

4. 异步逻辑没正确捕获异常 #

如果你用async/await处理查询，但没加try/catch，一旦查询出错，程序会跳过错误继续执行，导致后续代码访问undefined的rows：

错误写法：

async function getData() {
  const rows = await connection.query('SELECT * FROM wrong_table_name');
  console.log(rows.length); // 查询出错时rows是undefined，直接报错
}

正确写法：

async function getData() {
  try {
    const [rows] = await connection.query('SELECT * FROM your_table');
    console.log(rows.length);
  } catch (err) {
    console.error('查询或连接异常:', err);
  }
}

快速排查步骤总结 #

1. 先看控制台有没有打印MySQL的错误信息，很多时候错误信息直接告诉你问题出在哪；
2. 验证数据库连接是否正常；
3. 核对查询语句的语法和表/字段名；
4. 检查你用的MySQL库的API用法是否正确。

内容的提问来源于stack exchange，提问作者c-an