Express中Multer中间件在子路由下无法上传文件问题

子路由上传失效的核心原因是Multer存储路径的相对路径解析规则和你预期的不一致：
Multer的destination配置的相对路径，是相对于你执行node命令启动服务时的终端工作目录（也就是跑node app.js时所在的目录，一般是项目根目录），不是相对于当前编写Multer配置的JS文件所在的目录。

你在phoneRoutes.js里配置的存储路径是'../images'，这个路径是按「路由文件在routes文件夹，往上一级找images」的逻辑写的，但实际解析的时候会从项目根目录往上跳一级找images文件夹——这个目录基本不可能存在，Multer找不到合法的存储目录时会抛出文件系统错误，如果你没有做对应的错误捕获，就会表现为请求异常、文件没有正常存储、req.file返回undefined，看起来就像上传逻辑完全没生效。

作为对比，你在app.js里写的'./images'刚好和启动目录的相对路径匹配，所以根路由的上传能正常跑通。

• 优先用绝对路径替代相对路径，从根源避免路径解析歧义，用Node内置path模块配合__dirname（当前JS文件的所在绝对路径）拼接即可：

  1. 先在用到Multer的文件顶部引入path模块：

  const path = require('path');
  

  2. 修改对应文件里的storage配置：
     • app.js里的destination改成：

     cb(null, path.join(__dirname, './images'))
     

     • phoneRoutes.js里的destination改成：

     cb(null, path.join(__dirname, '../images'))
     

  改完之后不管你在哪个目录启动服务，路径都能准确指向项目根目录下的images文件夹，不会再出现路径找不到的问题。注意提前在项目里创建好images文件夹，Multer默认不会自动生成不存在的存储目录。

• 更省事的优化方案：不要在子路由里重复初始化Multer实例，直接把app.js里已经配置好的upload实例导出，在子路由文件里引入复用就行，既减少重复代码，也能彻底避免配置不一致、路径写错的问题。

如果改完路径还是上传失败，检查下你往/phones发POST请求时，表单里的文件字段名是不是严格为image，和upload.single('image')里配置的字段名完全一致，字段名大小写不匹配、漏传字段也会导致Multer不解析文件。

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