Node.js读取Postgres存储的Buffer转base64后图片损坏问题

存储逻辑错误是核心原因。
\x是PostgreSQL中bytea类型十六进制格式的SQL字面量前缀，仅在手写纯SQL语句拼接二进制值时需要使用。通过Node.js数据库驱动（pg/postgres等）传参写入时，驱动会自动处理Buffer类型的编码转换，不需要手动拼接该前缀。
当前存储代码手动将\\x拼在十六进制字符串前再转Buffer，相当于在原始图片二进制的头部额外写入了反斜杠（ASCII 0x5c）和x（ASCII 0x78）两个无效字节，读取出来的文件头部信息损坏，自然无法正常展示。

• 长度校验：取固定大小的测试图片做写入读取测试，对比原始Buffer长度和数据库读取出的Buffer长度，如果读取结果比原始数据多2字节，即可确认是头部冗余字符问题。
• 字段类型校验：确认存储图片的字段为bytea类型，禁止使用text/varchar类型存储二进制数据，字符集转义会导致二进制内容不可逆损坏。
• 驱动配置校验：确认pg驱动连接配置中bytea_output参数为默认值hex，不要修改为escape格式，否则会导致驱动解析Buffer出错。

修正存储逻辑 #

完全移除手动拼接\\x的冗余操作，直接将Base64字符串转为Buffer传入参数化查询即可，驱动会自动完成编码适配：

// 正确存储写法
const imageBuffer = Buffer.from(createEventDto.image, "base64");
// 直接将imageBuffer作为SQL参数传入，不要做额外的十六进制转码、前缀拼接
await db.insert(imageBuffer);

读取逻辑 #

现有读取逻辑本身没有问题，只要存储的二进制内容正确，直接调用Buffer的toString("base64")即可得到可用的Base64字符串：

const imageBuffer = await db.get();
return imageBuffer.toString("base64");

历史脏数据临时处理 #

如果数据库中已经存入了带头部冗余字节的历史数据，可以在读取时跳过前2个字节临时兼容，后续新数据写入必须使用正确逻辑：

const imageBuffer = await db.get();
// 裁掉开头2个无效字节
const validImageBuffer = imageBuffer.subarray(2);
return validImageBuffer.toString("base64");

注意：禁止通过字符串拼接SQL的方式写入bytea类型数据，必须使用参数化查询，既能避免编码错误，也能防范SQL注入风险。

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