NodeJS如何通过node-mysql2将接收的图片字节数组以Blob插入MySQL

核心原理 #

你接收到的0-255范围整数数组，本质就是二进制字节流的十进制表达，不需要手动转十六进制、不需要手动做SQL转义，只要把数组转成Node原生的Buffer实例，node-mysql2会自动将其识别为Blob类型完成参数绑定写入，全程没有额外的复杂处理。这套实现完全兼容NodeJS 12运行环境，不存在版本适配问题。

分步操作 #

1. 整数数组转Buffer实例
   • 当数组元素是0-255范围的无符号单字节值时，直接通过原生API转换即可：const imageBuffer = Buffer.from([137,80,78,71,...96,130])
   • 如果数组元素是范围在-128~127的有符号int8值，先做无符号转换再转Buffer，避免二进制错位：

     const unsignedBytes = signedInt8Array.map(val => val < 0 ? val + 256 : val)
     const imageBuffer = Buffer.from(unsignedBytes)
     

2. 数据库表字段适配
   • 建表时根据图片大小选择对应的二进制类型即可：小图标选BLOB、常规图片选MEDIUMBLOB、大尺寸图/动图选LONGBLOB，字段不受数据库连接字符集影响，不需要做特殊编码配置。
3. 执行参数化SQL写入
   • 不要手动拼接包含二进制内容的SQL字符串，直接将Buffer作为预编译语句的占位符参数传入即可，node-mysql2的参数绑定逻辑会自动处理二进制内容的转义，实际可运行的参考代码：

     // 复用项目中已初始化的mysql2连接池
     const dbPool = require('./common/dbPool')
     
     // 传入接口收到的整数数组即可
     async function storeImageBlob(intArray) {
       const binaryBuffer = Buffer.from(intArray)
       const insertSQL = `INSERT INTO image_store (img_blob, create_ts) VALUES (?, ?)`
       // 直接把Buffer作为参数传入，不需要额外处理
       const execResult = await dbPool.execute(insertSQL, [binaryBuffer, Date.now()])
       return execResult
     }
     

高频踩坑提醒 #

• 不要为了省事先把Buffer转成Base64字符串存在普通VARCHAR/TEXT字段里，这种方式会让二进制内容的存储体积上涨30%左右，完全浪费Blob字段的存储优势。
• Express侧配置JSON解析中间件时，记得根据传入图片的大小适当调大请求体体积限制，避免大尺寸的整数数组在JSON解析阶段被截断，导致写入的二进制文件损坏。
• 不需要手动给Buffer值拼接0x前缀、也不需要手动调用mysql2的escape方法处理Buffer内容，预编译的参数绑定逻辑已经做了全类型兼容，额外处理反而可能引入转义错误。

内容的提问来源于stack exchange，提问作者Martin S.