如何在Express与EJS中正确展示用户上传的图片?
核心问题定位
- 相对路径解析偏差:商品详情页访问地址为
/items/:item_id,模板中img标签使用的src="xxx.jpg"属于相对路径,浏览器会基于当前页面URL自动拼接出/items/xxx.jpg的请求地址,该请求会直接命中/items/:item_id的GET路由,将带后缀的图片文件名作为item_id参数查询MongoDB。由于文件名不符合ObjectId的格式要求,查询会直接抛出错误,最终表现为页面发起两次连续请求、报无法读取undefined属性的异常。 - 路由匹配顺序冲突:Express按注册顺序执行路由匹配,若处理/items路径的业务路由注册在静态资源中间件之前,即便静态目录中存在对应图片文件,请求也会优先被业务路由拦截,不会进入静态文件查找逻辑。
- 错误处理逻辑漏洞:
getItem接口中查询出错后没有中断后续执行流程,会在发送错误响应后继续执行模板渲染逻辑,触发ERR_HTTP_HEADERS_SENT报错。
可直接落地的修改步骤
为静态资源配置独立访问前缀,从根源上避免和业务路由冲突,修改静态资源挂载配置:
// 原配置:app.use(express.static(path.join(__dirname, 'imgs'))); // 修改为带公开访问前缀的形式 app.use('/uploads', express.static(path.join(__dirname, 'imgs')));配置完成后,imgs目录下的图片文件对外的正确访问地址为
/uploads/图片文件名,不会再和/items开头的业务路径产生匹配冲突。调整路由注册顺序,确保静态资源中间件优先于业务路由加载:
// 先注册静态资源中间件 app.use('/uploads', express.static(path.join(__dirname, 'imgs'))); // 再注册处理/items路径的业务路由 app.use('/items', itemRouter);修改EJS模板中的img标签引用路径,使用绝对路径避免相对路径解析错误:
<!-- 原错误写法:<img src="<%= it._id.toString() + '.jpg' %>" alt="image"> --> <!-- 修改为带静态资源前缀的绝对路径 --> <img src="/uploads/<%= it._id.toString() + '.jpg' %>" alt="image">补全接口的错误中断逻辑,避免重复发送响应:
exports.getItem = function(req, res){ Item.findOne({ _id:req.params.item_id }, function(err, item){ // 原逻辑:出错后未中断执行,会导致重复响应 // if(err) res.send(err); // 修改为出错后立即return,终止后续流程 if(err) return res.send(err); console.log("In getItem..."); console.log(req.params.item_id); console.log(item); res.render('item', { it: item }); }); };对齐上传文件的命名规则:当前multer存储配置生成的临时文件名为
tmp.原扩展名,需要在itemController.postItem的逻辑中,在MongoDB商品文档创建完成后,将临时文件重命名为商品文档_id + 原扩展名格式并存入imgs目录,确保模板拼接的文件名和实际存储的文件名一致。
内容的提问来源于stack exchange,提问作者Arko Chatterjee
相关产品推荐
相关产品推荐

