ExpressJS上传文件跨服务转发报Expected a stream错误如何解决

报错Error: Expected a stream at Object.getStream [as default]的直接原因是files[0].stream的值不是合法的可读流，大概率是你使用的文件上传中间件（常见如multer）没有配置为流模式，此时files[0].stream为undefined或其他非流类型值，传入getStream就会抛出该错误。
另外你的现有代码还有隐藏问题：手动设置Content-Type: multipart/form-data时没有携带boundary参数，下游服务无法正确解析FormData内容，就算流问题修复后请求也会失败。

快速修复（无需改动上传中间件配置） #

如果你当前用的是multer默认内存存储配置，直接读取文件自带的buffer即可，不需要额外调用getStream转格式：

const files = req.files;
const filename = files[0].originalname;

const formFile = new FormData();
// 直接使用multer提供的文件buffer
formFile.append('image', files[0].buffer, filename);

axios.post("http://localhost:1401/content/image/test/upload/", formFile, {
  // 不需要手动设置Content-Type，FormData会自动生成带boundary的正确请求头
  headers: formFile.getHeaders()
})
.then(response => res.send(response.data))
.catch((error) => {
  const { status, data } = error.response || { status: 500, data: '服务错误' };
  res.status(status).send(data);
})

流模式实现（符合最佳实践） #

如果要处理大文件、降低服务内存占用，推荐用流模式实现转发，无需把完整文件加载到内存：

1. 先修改multer配置，启用流式处理：

import multer from 'multer';
// 配置multer不将文件存储到内存或磁盘，直接返回可读流
const upload = multer({ storage: multer.memoryStorage() });

2. 转发逻辑修改为直接传递流：

const files = req.files;
const filename = files[0].originalname;
const fileStream = files[0].stream;

const formFile = new FormData();
formFile.append('image', fileStream, filename);

axios.post("http://localhost:1401/content/image/test/upload/", formFile, {
  headers: formFile.getHeaders(),
  responseType: 'stream'
})
.then(response => {
  // 下游响应直接回传给客户端，减少内存占用
  response.data.pipe(res);
})
.catch((error) => {
  const { status, data } = error.response || { status: 500, data: '转发失败' };
  res.status(status).send(data);
})

流处理完全符合该场景的最佳实践，优势包括：

• 内存占用低：无需将完整文件加载到服务内存，大文件、高并发场景下服务稳定性更高
• 延迟更低：支持边接收客户端上传的文件，边转发给下游服务，不用等完整文件上传完成再启动转发流程
• 资源消耗少：省去了文件读取、buffer转换的额外CPU开销

如果不需要在转发前做鉴权、参数校验等业务逻辑，更优的方案是直接在K8s的Ingress层配置路径转发规则，把上传请求直接路由到图片处理服务，完全跳过Express层，进一步降低性能损耗。

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