NodeJS二进制图片上传Python服务异常及binary编码问题解析

核心认知偏差 #

很多开发者会直观认为“处理二进制图片就该用binary编码读取”，这个认知完全不符合Node.js的编码设计逻辑，也是这次数据损坏的核心原因。

为什么加了encoding: 'binary'会破坏文件数据 #

Node.js里的binary编码本质是latin1单字节字符集的别名，它的行为从来不是“原样读取二进制字节不做转换”：

• 当你传入{ encoding: 'binary' }调用readFileSync时，Node会把读取到的每一个原始字节，映射成latin1字符集对应的Unicode字符串（每个原始字节会变成一个占两个字节的UTF-16字符串单元）
• 后续当你把这个字符串传给FormData、或者用writeFileSync写回磁盘时，系统会默认按照UTF-8编码把字符串重新转成字节流。这一步强制的UTF-8重编码是数据损坏的直接原因：所有大于0x7F的非ASCII字节，都会被UTF-8规则编码成2个甚至更多的新字节，原本的原始字节序列被完全篡改，文件长度、字节内容全部和源文件不一致，自然无法正常打开。

为什么去掉encoding参数就能解决问题 #

当你调用readFileSync时不传入任何encoding参数，方法会直接返回Buffer对象——这才是Node.js中存储、传递原始二进制数据的正确载体：

• Buffer是直接在内存中按字节序列存储数据的，全程不会触发任何字符集编码转换
• 不管是把Buffer塞进FormData上传，还是传给writeFileSync写回磁盘，都不会对原始字节做篡改，整个传输过程的二进制内容和源文件完全一致。
  你在测试代码里给imageDest2.png写的注释存在笔误：实际用Buffer写回的文件是可以正常打开的，注释里的CANNOT属于手滑写错的内容，不影响核心结论。

正确的二进制上传实现要点 #

要实现无损坏的图片上传，只需要确保文件读取阶段拿到的是Buffer对象即可，不需要做任何额外的编码处理：

• 直接去掉读取文件时的encoding参数，拿到Buffer对象
• 或者显式传入encoding: null，和上面的效果完全一致
• 不要把通过binary/latin1编码读取到的字符串直接用于文件上传、写回操作，这类字符串只适合做临时的单字节文本过渡，不适合承载原始二进制流。

补充：早期Node.js文档对binary编码的描述存在一定误导性，让很多开发者误以为它是直通二进制流的专用编码，实际上它的设计目的从来不是替代Buffer处理原始二进制数据。

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