使用Dockerode在Node.js中生成mysqldump文件时MIME类型异常

问题根源在于Docker exec API返回的流采用了帧格式传输——每个输出块前带有4字节的控制头部（1字节标识流类型，3字节大端表示数据长度），这些二进制头部直接写入文件后，会让文件变成application/octet-stream类型，还会出现乱码。

针对大型数据库备份，必须用流处理的方式剥离这些头部，避免加载整个文件到内存。下面是具体实现：

const Docker = require('dockerode');
const fs = require('fs');
const { Transform } = require('stream');

const docker = new Docker();
const container = docker.getContainer('你的容器ID或名称');

// 创建Transform流，过滤Docker exec的帧头部
const stripDockerFrameHeader = new Transform({
  transform(chunk, encoding, callback) {
    let offset = 0;
    // 处理当前chunk中可能包含的多个帧
    while (offset < chunk.length) {
      // 解析帧头部：1字节流类型 + 3字节数据长度（大端）
      const dataLength = chunk.readUIntBE(offset + 1, 3);
      const frameEnd = offset + 4 + dataLength;
      // 提取纯备份数据部分
      const pureData = chunk.slice(offset + 4, frameEnd);
      this.push(pureData);
      offset = frameEnd;
    }
    callback();
  }
});

// 执行mysqldump备份命令
container.exec({
  Cmd: ['mysqldump', '-u', '你的用户名', '-p你的密码', '目标数据库名'],
  AttachStdout: true,
  AttachStderr: false // 如需捕获错误输出可设为true，后续在transform中区分流类型处理
}, (err, exec) => {
  if (err) throw err;

  exec.start({ hijack: true, stdin: false }, (err, stream) => {
    if (err) throw err;

    // 流管道：Docker输出流 → 头部过滤流 → 文件写入流
    stream.pipe(stripDockerFrameHeader).pipe(fs.createWriteStream('backup.sql'))
      .on('finish', () => {
        console.log('备份完成，文件格式已修复');
      })
      .on('error', (err) => {
        console.error('备份出错:', err);
      });
  });
});

关键细节说明： #

• 直接用chunk.toString()无效，因为头部的二进制字节会被转成乱码字符串，必须通过Buffer操作剥离二进制头部
• Transform流基于流处理，逐块过滤头部，不会占用大量内存，完全适配大型数据库备份场景
• 如果需要处理stderr输出，可在transform中判断帧头部的第一个字节（1=stdout，2=stderr），单独处理错误流

处理后生成的SQL文件将恢复为text/plain类型，用Sublime等编辑器打开不会出现乱码。

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