使用mysql-2-async执行多语句SQL失败，DataGrip可正常运行

可能的原因及对应解决方法 #

1. SQL语句含隐藏特殊字符 #

代码拼接SQL时可能引入不可见特殊字符（如全角空格、异常编码的换行/制表符），这些字符在错误日志中不显示，但会导致MySQL解析失败。

• 处理方式：
  • 用JSON.stringify(sql)打印生成的SQL，排查隐藏字符；
  • 用正则清理非打印字符：

    const cleanedSql = sql.replace(/[\x00-\x1F\x7F]/g, '');
    

2. 动态SQL拼接的转义问题 #

如果手动拼接表名、字段名等动态内容，普通字符串转义可能无效，需用mysql2提供的专用转义方法。

• 错误示例（无转义直接拼接）：

  const sql = `DROP TABLE IF EXISTS ${tableName}; INSERT INTO ...`;
  

• 正确做法（用escapeId转义标识符）：

  const escapedTableName = connection.escapeId(tableName);
  const sql = `DROP TABLE IF EXISTS ${escapedTableName}; INSERT INTO ...`;
  

3. 多语句执行未开启默认支持 #

mysql2默认禁止一次执行多条SQL语句，若你的SQL包含DROP TABLE和INSERT两条语句，会触发解析错误。

• 处理方式：
  • 连接时开启multipleStatements选项：

    const connection = await mysql.createConnection({
      host: 'localhost',
      user: 'your_user',
      password: 'your_pwd',
      database: 'your_db',
      multipleStatements: true
    });
    

  • 或拆分SQL分两次执行：

    await connection.execute('DROP TABLE IF EXISTS your_table');
    await connection.execute('INSERT INTO your_table (col1) VALUES (?)', [value1]);
    

4. 字符集不匹配 #

代码SQL的字符集与MySQL服务器默认字符集不一致时，可能引发编码解析问题。

• 处理方式：
  • 连接时指定字符集：

    const connection = await mysql.createConnection({
      // 其他配置项
      charset: 'utf8mb4'
    });
    

  • 确保代码文件编码为UTF-8，避免特殊字符乱码。

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