本教程旨在解决在使用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动态路径（无法显示）：
<img src="images/">
尽管变量本身在页面上能正确渲染出图片名称（例如 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 访问。
千帆AppBuilder
百度推出的一站式的AI原生应用开发资源和工具平台，致力于实现人人都能开发自己的AI原生应用。
158 查看详情
浏览器对相对路径的解析：当浏览器解析HTML中的src属性时，如果路径不是以 / 开头的（即相对路径），它会相对于当前页面的URL来解析。
假设用户访问的页面URL是 http://localhost:3000/create。当浏览器遇到 <img src="images/”> 时，它会将 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中的图片路径 (推荐)
最直接且推荐的解决方案是确保标签的src属性使用从网站根目录开始的绝对路径。
核心思想： 在src属性值前添加一个前导斜杠 /，强制浏览器从网站的根目录开始解析路径，而不是相对于当前页面的URL。
服务器端Express配置（示例）：请确保您的express.static配置正确，将图片目录映射到您期望的URL路径
以上就是解决EJS动态图片路径在Express应用中无法显示的问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/923859.html
微信扫一扫 
支付宝扫一扫 
