使用mysql2的execute()批量插入失败，该如何解决？

问题原因 #

execute() 依赖MySQL的预编译语句（Prepared Statement），而MySQL的预编译语法不支持 VALUES ? 这种将整个批量值列表作为单个占位符的写法——这种语法是mysql2的query()方法特有的客户端层面扩展，并非标准SQL预编译的一部分，所以execute()无法识别该占位符，直接抛出语法错误。

正确的execute()批量插入实现 #

要通过execute()实现安全且高性能的批量插入，需要为每一行数据单独构造(?,?)形式的占位符组，再将所有参数扁平化处理：

1. 动态生成对应行数的占位符字符串
2. 将二维参数数组扁平化为一维数组
3. 传入execute()执行

示例代码：

const mysql = require('mysql2/promise');

async function batchInsert() {
  const connection = await mysql.createConnection({
    host: 'localhost',
    user: 'your_user',
    password: 'your_password',
    database: 'your_db'
  });

  try {
    const data = [["id1", 1], ["id2", 2], ["id3", 3]];
    // 生成对应行数的占位符：(?,?), (?,?), (?,?)
    const rowPlaceholders = data.map(() => '(?, ?)').join(', ');
    const sql = `INSERT INTO my_table (user_id, score) VALUES ${rowPlaceholders}`;
    // 扁平化参数数组：["id1",1,"id2",2,"id3",3]
    const flatParams = data.flat();

    const [results] = await connection.execute(sql, flatParams);
    console.log(`成功插入 ${results.affectedRows} 行`);
  } catch (err) {
    console.error('插入失败:', err);
  } finally {
    await connection.end();
  }
}

batchInsert();

是否需要改用query()？ #

不推荐在高并发场景下改用query()：

• query()的VALUES ?是客户端将参数展开为完整SQL后发送给服务器，每次执行都需要重新解析SQL，无法利用MySQL的预编译语句缓存，高并发下性能损耗明显。
• 上述execute()实现既保留了预编译语句的性能优势（服务器可缓存执行计划），又能实现批量插入，同时完全避免SQL注入风险。

如果遇到数据量极大（比如上万行）的情况，可以考虑拆分批次插入，避免单条SQL过长导致的性能问题，但核心仍建议使用execute()的预编译方式。

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