MySQL连接正常但插入数据失败：Cannot read properties of undefined (reading 'execute')

错误详情 #

在Node.js Express项目中，已确认MySQL数据库连接成功建立，但插入记录时失败。报错代码位于mysql-utils.js：

const [rows] = await connection.execute('SELECT * FROM tracks WHERE isrc = ?', [trackData.isrc]);

错误信息：

Error inserting data: Cannot read properties of undefined (reading 'execute')

项目核心文件包括index.js、track-save.js、mysql-connection.js、mysql-utils.js，业务逻辑为通过Spotify API获取曲目数据后写入MySQL。已尝试传递connection对象给insertData函数、将let改为var，问题未解决。

复现步骤 #

• 执行node index.js启动Express服务器
• 启动MySQL服务
• 在Postman中调用http://localhost:4000/track/save，传入JSON参数{"isrc":"GBAYE0601477"}
• 控制台输出上述错误信息

排查与解决方向 #

1. 确认connection对象传递链路完整 #

检查mysql-utils.js中执行查询的函数是否实际接收到有效connection对象。可能是函数调用时未正确传入，或传递过程中对象被意外覆盖/销毁。示例正确调用方式：

// 从连接工具中获取连接后传入utils函数
const connection = await getConnection();
await mysqlUtils.insertTrack(connection, trackData);

2. 验证连接获取逻辑的可靠性 #

查看mysql-connection.js的连接创建/获取代码，确保返回的是有效MySQL连接实例（以mysql2/promise为例）：

// mysql-connection.js 正确示例
const mysql = require('mysql2/promise');
const pool = mysql.createPool({
  host: 'localhost',
  user: 'your-username',
  password: 'your-password',
  database: 'your-db-name'
});

async function getConnection() {
  return await pool.getConnection();
}
module.exports = { getConnection };

3. 避免连接对象被提前释放 #

如果在调用execute前，connection已被调用release()或end()，会导致对象变为undefined。需确保查询完成后再释放连接：

// 错误示例：提前释放连接
const connection = await getConnection();
connection.release();
await connection.execute(...);

// 正确示例：查询完成后释放
const connection = await getConnection();
try {
  await connection.execute(...);
} finally {
  connection.release();
}

4. 检查异步逻辑顺序 #

确保调用connection.execute前，connection对象已通过await完成初始化，避免因异步时序问题导致对象未就绪。

内容的提问来源于stack exchange，提问作者Pramod Gangadar