Node.js用Prepared Statement向MySQL插字节数组报错：列数不匹配

问题根源 #

你的MySQL驱动（如mysql/mysql2）会自动将数组类型的参数展开为多个独立值。原本传入的[jsonData.userEmail, [80,75,3,4]]被解析成了[jsonData.userEmail, 80,75,3,4]，对应到SQL语句里就变成了VALUES('name@company.com',80,75,3,4)，但你只声明了2列，因此触发ER_WRONG_VALUE_COUNT_ON_ROW错误。

解决方案 #

根据workbook_data列的类型选择对应处理方式：

1. 列类型为BLOB（存储原始字节数据）

将字节数组转为Buffer，驱动会将其识别为单个参数：

const query = 'INSERT INTO spreaddata.workbook (user_email, workbook_data) VALUES(?,?)';
sql.query(query, [jsonData.userEmail, Buffer.from(jsonData.workbook_data)]);

2. 列类型为JSON（存储数组的JSON结构）

将字节数组转为JSON字符串，存入JSON列：

const query = 'INSERT INTO spreaddata.workbook (user_email, workbook_data) VALUES(?,?)';
sql.query(query, [jsonData.userEmail, JSON.stringify(jsonData.workbook_data)]);

3. 兜底方式（强制驱动不展开数组）

用额外的数组包裹字节数组，避免驱动拆分参数：

const query = 'INSERT INTO spreaddata.workbook (user_email, workbook_data) VALUES(?,?)';
sql.query(query, [jsonData.userEmail, [jsonData.workbook_data]]);

注意事项 #

• 确保列类型与存储数据匹配：字节数据用BLOB系列类型，JSON结构用JSON类型，不要用普通字符串列存储字节数组，会导致数据损坏。
• 优先使用最新版的mysql2驱动，对Buffer和复杂类型的支持更稳定。

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