Express.js同逻辑POST下载xlsx文件体积偏大损坏问题

不需要为POST下载接口额外设置特殊响应头，问题和请求方法本身无关，是POST请求场景下的二进制流处理逻辑错误导致的。

根因说明 #

你遇到的「GET正常、POST返回文件体积翻倍且损坏」是非常典型的二进制响应编码错误，和后端响应头没有关系：

• 用GET触发下载时，普遍是通过地址栏跳转、window.open、原生表单提交发起请求，浏览器识别到Content-Disposition: attachment头后，会直接把响应体按二进制流处理落盘，不会做额外编码转换，所以文件正常。
• 用POST触发下载时，基本都是通过fetch/axios/XMLHttpRequest发起AJAX请求，这类API默认会将响应体按UTF-8文本格式解码。xlsx本身是二进制压缩格式，被强行按文本解码后再转成文件保存时，会因为编码映射错误导致内容膨胀、文件结构损坏，正好对应你观察到的体积翻倍、无法打开的现象。

另外你贴的后端代码里有一处冗余写法：当res.write()的第一个参数是Buffer类型时，不需要传入第二个'binary'编码参数，部分Node.js版本下这个冗余参数会触发不必要的编码转换，埋下兼容隐患。

修复步骤 #

1. 简化后端响应逻辑，不需要手动调用write+end，直接用Express的send方法处理Buffer即可，可选显式设置Content-Length提升兼容性：

export async function postDownloadMyFile (
  req: Request,
  res: Response,
  next: NextFunction
): Promise<Response> {

  // ... xlsx 工作簿生成逻辑
  const buffer =  await workBook.xlsx.writeBuffer();

  res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
  res.setHeader('Content-Disposition', 'attachment; filename=MyFile.xlsx');
  res.setHeader('Content-Length', buffer.length);
  res.send(buffer);

  return res;
}

2. 前端发起POST请求时，必须显式指定响应类型为二进制格式，禁止使用默认的文本解析逻辑：
   • axios请求：增加配置项 responseType: 'blob'
   • fetch请求：拿到响应对象后，调用response.blob()或response.arrayBuffer()获取二进制内容，不要调用response.text()
   • 原生XHR请求：设置xhr.responseType = 'blob'

POST方法本身完全支持返回二进制流实现文件下载，只要前后端统一按二进制规则处理流内容，就不会出现异常，不需要额外添加特殊响应头。

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