本教程旨在解决在使用EJS模板引擎和Express框架时，动态设置图片src属性导致图片无法加载的问题。文章将深入分析Express静态文件服务与浏览器路径解析机制，提供两种核心解决方案：通过调整HTML中src路径为绝对路径，或使用客户端JavaScript动态设置图片源，确保图片正确显示。
1. 问题剖析：EJS动态路径与Express静态文件服务
在Express应用中使用EJS模板引擎动态展示图片时，开发者常遇到一个令人困惑的问题：当图片路径硬编码在HTML中时能够正常显示，但当使用EJS变量动态填充src属性时，图片却无法加载。
现象复现：假设您的服务器端代码通过Express的express.static中间件配置了静态文件服务，例如：
// server.js 或 app.jsconst express = require('express');const path = require('path');const app = express();// 假设您的图片存储在项目根目录下的 'uploads/images' 文件夹中// 并希望通过 '/images/your-image.jpg' 这样的URL访问app.use('/images', express.static(path.join(__dirname, 'uploads', 'images')));// 其他路由...app.get('/create', (req, res) => { const nameOfImg = '2022-07-16T13-40-30.352Z104879.jpg'; // 假设这是从数据库获取的图片名称 res.render('createPage', { name: nameOfImg });});app.listen(3000, () => console.log('Server running on port 3000'));
在EJS模板 (createPage.ejs) 中：
硬编码路径（工作正常）：
@@##@@
EJS动态路径（无法显示）：
@@##@@">
尽管变量本身在页面上能正确渲染出图片名称（例如 2022-07-16T13-40-30.352Z104879.jpg），但图片却加载失败，浏览器开发者工具的网络请求中会显示404错误。
根本原因分析：问题的核心在于浏览器如何解析HTML中
标签的src属性值，以及express.static中间件如何映射文件路径到URL。
express.static的工作原理：app.use(‘/images’, express.static(path.join(__dirname, ‘uploads’, ‘images’))); 这行代码告诉Express：将 uploads/images 目录下的所有文件，通过 /images 这个URL前缀对外提供服务。例如，uploads/images/my-photo.jpg 将可以通过 http://localhost:3000/images/my-photo.jpg 访问。
浏览器对相对路径的解析：当浏览器解析HTML中的src属性时，如果路径不是以 / 开头的（即相对路径），它会相对于当前页面的URL来解析。
假设用户访问的页面URL是 http://localhost:3000/create。当浏览器遇到 <img src="images/” alt=”解决EJS动态图片路径在Express应用中无法显示的问题” > 时，它会将 images/ 视为相对于 /create 的路径。因此，浏览器会尝试请求 http://localhost:3000/create/images/2022-07-16T13-40-30.352Z104879.jpg。然而，根据我们的 express.static 配置，图片实际上是通过 http://localhost:3000/images/2022-07-16T13-40-30.352Z104879.jpg 访问的。express.static 并没有配置在 /create 路径下提供静态文件，所以对 /create/images/… 的请求自然会返回404错误。
硬编码的 之所以能工作，很可能是因为在测试时页面URL不是 /create，或者存在其他隐式配置导致其被正确解析。但在 /create 页面下，它也会遇到同样的问题。
2. 解决方案一：优化HTML中的图片路径 (推荐)
最直接且推荐的解决方案是确保<img src="images/%E6%A0%87%E7%AD%BE%E7%9A%84src%E5%B1%9E%E6%80%A7%E4%BD%BF%E7%94%A8%E4%BB%8E%E7%BD%91%E7%AB%99%E6%A0%B9%E7%9B%AE%E5%BD%95%E5%BC%80%E5%A7%8B%E7%9A%84%E7%BB%9D%E5%AF%B9%E8%B7%AF%E5%BE%84%E3%80%82
%E6%A0%B8%E5%BF%83%E6%80%9D%E6%83%B3%EF%BC%9A%20%E5%9C%A8src%E5%B1%9E%E6%80%A7%E5%80%BC%E5%89%8D%E6%B7%BB%E5%8A%A0%E4%B8%80%E4%B8%AA%E5%89%8D%E5%AF%BC%E6%96%9C%E6%9D%A0%20/%EF%BC%8C%E5%BC%BA%E5%88%B6%E6%B5%8F%E8%A7%88%E5%99%A8%E4%BB%8E%E7%BD%91%E7%AB%99%E7%9A%84%E6%A0%B9%E7%9B%AE%E5%BD%95%E5%BC%80%E5%A7%8B%E8%A7%A3%E6%9E%90%E8%B7%AF%E5%BE%84%EF%BC%8C%E8%80%8C%E4%B8%8D%E6%98%AF%E7%9B%B8%E5%AF%B9%E4%BA%8E%E5%BD%93%E5%89%8D%E9%A1%B5%E9%9D%A2%E7%9A%84URL%E3%80%82
%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AB%AFExpress%E9%85%8D%E7%BD%AE%EF%BC%88%E7%A4%BA%E4%BE%8B%EF%BC%89%EF%BC%9A%0A%E8%AF%B7%E7%A1%AE%E4%BF%9D%E6%82%A8%E7%9A%84express.static%E9%85%8D%E7%BD%AE%E6%AD%A3%E7%A1%AE%EF%BC%8C%E5%B0%86%E5%9B%BE%E7%89%87%E7%9B%AE%E5%BD%95%E6%98%A0%E5%B0%84%E5%88%B0%E6%82%A8%E6%9C%9F%E6%9C%9B%E7%9A%84URL%E8%B7%AF%E5%BE%84
以上就是解决EJS动态图片路径在Express应用中无法显示的问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1582581.html
微信扫一扫 
支付宝扫一扫 
