如何修改Multer返回的文件上传路径以移除public文件夹前缀?
问题说明
- 技术场景:在 Express 框架中结合 Multer 实现文件上传,搭配 EJS 模板引擎做页面渲染
- 现有配置逻辑:
- 已将项目下的
public目录设置为 Express 静态资源托管目录,前端可直接通过对应路径访问public下的文件 - Multer存储引擎的上传目标路径设置为
./public/upload
- 已将项目下的
- 遇到的问题:上传完成后返回的文件路径自带
public\前缀,示例返回值为public\upload\profile_1609198415143.PNG,该路径和静态资源托管的访问规则不匹配,需要去掉路径中的public前缀
现有业务配置代码
Express应用初始化配置
const app = express(); app.use(express.static("public")); app.set("view engine", "ejs"); app.use(bodyParser.urlencoded({ extended: false })); app.use(bodyParser.json()); app.use('/profile', express.static('uploads'));
Multer存储引擎配置
const storage = multer.diskStorage({ destination: './public/upload', filename: (req, file, cb) => { return cb(null, `${file.fieldname}_${Date.now()}${path.extname(file.originalname)}`) } }) const upload = multer({ storage: storage, limits:{ fileSize: 10485760 } }) function errHandler(err, req, res, next) { if (err instanceof multer.MulterError) { res.json({ success: 0, message: err.message }) } } app.use(errHandler);
实现方案
首先明确两个概念的区别:
- Multer配置里的
destination是服务器本地磁盘的物理存储路径,仅用于让Multer知道要把上传的文件存在服务器哪个文件夹下,不会自动生成给前端返回的访问路径 - Express的
express.static配置是磁盘路径到URL路径的映射规则:本地的public文件夹内容,对应URL根路径的访问权限,也就是说本地public/upload/xxx.png文件,前端实际可以通过/upload/xxx.png直接访问,完全不需要在URL里加public
之前返回的路径带public前缀,本质是在写上传接口响应时,直接把req.file对象里携带的物理磁盘路径当作访问路径返回了,所以才会出现多余的前缀。
具体修改方式:
- 保持Multer的物理存储路径配置不变,还是将文件存在
./public/upload下 - 在上传接口生成响应时,不要直接返回
req.file.path的物理路径,而是按照静态资源映射规则,手动拼接不带public前缀的访问路径返回
示例代码对比:
原错误写法(直接返回物理路径):
app.post('/upload', upload.single('profile'), (req, res) => { // req.file.path 就是带public前缀的本地物理路径 res.json({ success: 1, filePath: req.file.path }) })
修改为正确写法(手动生成匹配静态规则的访问路径):
app.post('/upload', upload.single('profile'), (req, res) => { // 基于已知的静态托管映射规则拼接路径 const accessPath = `/upload/${req.file.filename}`; res.json({ success: 1, filePath: accessPath }) })
注意事项:
- 不推荐用字符串替换的方式去掉
public\前缀:Windows下路径分隔符是反斜杠,Linux下是正斜杠,硬编码替换规则会在跨平台部署时出现兼容问题 - 如果不想把上传文件存在public目录下,只要保持逻辑一致即可:将Multer的destination改为项目根目录的
./uploads,配合已有的app.use('/profile', express.static('uploads'))映射规则,上传接口返回/profile/${req.file.filename}即可,完全不需要额外修改其他配置
内容的提问来源于stack exchange,提问作者Mayank saini
相关产品推荐
相关产品推荐

