Node.js使用node-mysql2直接插入Buffer为BLOB的正确方式（无需序列化）

别担心，Node.js完全支持直接把Buffer以二进制形式写入BLOB字段，不需要转成字符串或十六进制——你遇到的ER_TRUNCATED_WRONG_VALUE_FOR_FIELD错误，本质是数据库驱动默认把Buffer当成UTF-8字符串处理了，导致二进制数据里的非UTF-8字节触发了校验错误。下面是具体的解决步骤，分两种常用库说明：

一、推荐使用mysql2（更友好的二进制支持） #

mysql2是mysql库的升级版本，对Buffer的处理更智能，默认就能识别并以二进制形式传递给预处理语句，不需要额外配置。

示例代码 #

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

async function insertBufferToBlob() {
  // 建立数据库连接
  const conn = await mysql.createConnection({
    host: '你的数据库地址',
    user: '用户名',
    password: '密码',
    database: '数据库名'
  });

  // 准备要插入的Buffer（这里以读取本地二进制文件为例）
  const binaryBuffer = fs.readFileSync('./test.bin');

  try {
    // 直接把Buffer作为预处理参数传入，不需要任何转换
    const [result] = await conn.execute(
      'INSERT INTO your_table (blob_column) VALUES (?)',
      [binaryBuffer]
    );
    console.log(`插入成功，记录ID: ${result.insertId}`);
  } catch (err) {
    console.error('插入失败:', err);
  } finally {
    await conn.end();
  }
}

insertBufferToBlob();

二、如果使用旧版mysql库 #

旧版mysql库不会自动识别Buffer类型，需要显式指定参数为BLOB类型才能绕过UTF-8校验：

示例代码 #

const mysql = require('mysql');
const fs = require('fs');

const conn = mysql.createConnection({
  host: '你的数据库地址',
  user: '用户名',
  password: '密码',
  database: '数据库名'
});

const binaryBuffer = fs.readFileSync('./test.bin');

conn.query(
  'INSERT INTO your_table (blob_column) VALUES (?)',
  // 显式用mysql.Types.BLOB包装Buffer，强制以二进制形式传递
  [new mysql.Types.BLOB(binaryBuffer)],
  (err, result) => {
    if (err) throw err;
    console.log(`插入成功，影响行数: ${result.affectedRows}`);
    conn.end();
  }
);

关键注意事项 #

• 确保数据库字段类型正确：必须是BLOB/MEDIUMBLOB/LONGBLOB中的一种，绝对不能用TEXT/VARCHAR这类字符串类型——字符串字段会强制UTF-8校验，非UTF-8的二进制字节必然触发你遇到的错误。
• 不要手动转换Buffer：绝对不要用buffer.toString()或者buffer.toString('hex')这类方法转成字符串再插入，这样不仅会增加额外开销，还会丢失二进制数据或触发编码错误。
• 优先选择mysql2：它的预处理语句性能更好，对二进制数据的支持更完善，几乎不会出现这类编码适配问题。

内容的提问来源于stack exchange，提问作者V.B.