Express-fileupload仅首个挂载路由生效 req.files为null问题排查

Node.js的HTTP请求是可读流，流数据只能被消费一次，只要有任意中间件提前读取了multipart/form-data类型请求的流内容，后续的express-fileupload就无法解析出文件对象。
你遇到的「只有第一个挂载的路由能正常获取req.files，后续路由全部返回null」，本质是第一个路由处理时请求流还未被消费，等执行到后续路由时，流已经被前置的全局/路由级中间件读取完毕了。

最常见的触发场景：

• app.use(fileUpload())之后挂载的其他全局中间件（即你代码中...other middlewares省略的部分）存在无差别读取请求流的逻辑，比如配置错误的express.json()/express.urlencoded()（修改了type匹配规则，把multipart/form-data纳入了解析范围）、自定义日志中间件直接读取请求内容、其他第三方请求体解析库等。
• 先于image-host路由挂载的blog-post-routes/comment-routes文件中，通过router.use()注册了路由级的请求体解析/流读取逻辑，这类中间件即使没有匹配到对应路由路径，也会消费请求流。

按以下步骤逐一排查调整：

1. 调整全局中间件顺序，严格限定各解析中间件的生效范围
   把express-fileupload放在所有请求体解析类中间件的最前面，同时给JSON、urlencoded类型的解析中间件明确指定匹配的Content-Type，禁止覆盖multipart类型，参考配置：

   const fileUpload = require("express-fileupload");
   const app = express();
   
   // 最先挂载文件上传解析中间件
   app.use(fileUpload({
     createParentPath: true,
     limits: { fileSize: 50 * 1024 * 1024 } // 按需配置文件大小限制
   }));
   // 挂载JSON解析，仅处理application/json类型请求
   app.use(express.json({ type: "application/json" }));
   // 挂载普通表单解析，仅处理application/x-www-form-urlencoded类型请求
   app.use(express.urlencoded({ extended: true, type: "application/x-www-form-urlencoded" }));
   
   // 其他业务中间件（鉴权、日志、跨域等）放在这里
   // ...
   
   // 最后挂载所有路由
   app.use(require("./src/routers/user-routes"));
   app.use(require("./src/routers/blog-post-routes"));
   app.use(require("./src/routers/comment-routes"));
   app.use(require("./src/routers/image-host-routes"));
   

2. 排查所有路由文件的全局中间件
   检查user-routes.js、blog-post-routes.js、comment-routes.js三个文件，删除所有通过router.use()注册的请求体解析、流读取逻辑，这类逻辑统一放到全局中间件层处理。重点排查是否存在直接读取req流、打印完整req/req.body的逻辑，这类代码会直接消费掉请求流。
3. 校验请求头配置
   调用/img/upload接口时，确保请求头Content-Type为multipart/form-data; boundary=xxx格式，不要手动设置boundary值，交给前端请求库（axios、fetch、FormData等）自动生成即可，手动设置boundary会导致解析失败。
4. 加调试日志定位问题点
   如果以上调整后仍异常，添加两个日志中间件定位流被消费的位置：

   // 放在fileUpload前面
   app.use((req, res, next) => {
     console.log("请求进入，Content-Type:", req.get("Content-Type"));
     next();
   });
   app.use(fileUpload());
   // 放在fileUpload后面
   app.use((req, res, next) => {
     console.log("fileUpload执行完成，req.files是否存在:", !!req.files);
     next();
   });
   

   • 如果访问/img/upload时第二个日志显示req.files为false，说明流在fileUpload执行前就被消费了，往前排查全局中间件即可。
   • 如果第二个日志显示req.files为true，但进入路由后打印为null，说明fileUpload和路由之间的某个中间件清空了req.files或者消费了流，逐个排查中间件即可。

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