生产环境图片不显示主因是路径解析偏差,尤其受base标签、子目录部署及前端路由影响;需确保HTML base、路由base与构建配置三者一致,并优先使用根相对路径或构建工具自动处理资源引用。

生产环境路由跳转后图片不显示,往往不是图片本身坏了,而是路径解析出了偏差——尤其当项目部署在子目录、用了 标签、或混合了相对路径与前端路由时,浏览器对 src、fetch、import() 的路径解析逻辑会悄然变化,导致资源请求发向错误地址。
base 标签让所有“纯相对路径”改换基准
一旦写进 ,它就会影响所有未带协议、未以 / 开头、也未含 : 的 URL:
-
→ 实际请求
https://example.com/my-app/logo.png(而非当前 HTML 所在目录) -
fetch('./api/user')→ 发向https://example.com/my-app/api/user -
import('./utils')→ 报错Failed to resolve module specifier
但这些不受影响:window.location.href、history.pushState('page', '', 'detail')、内联 JS 字符串如 el.src = 'icon.png'(纯字符串,不被解析)。
Vue/React 等 SPA 中,base 和 router base 必须严格一致
比如你部署在 https://example.com/admin/:
- HTML 中需写
- Vue Router 配置必须设
base: '/admin/' - Vite 构建需配
base: '/admin/',Webpack 则对应output.publicPath: '/admin/'
三者只要有一个不一致,就会出现:链接点击正常,但跳转后图片 404;或者路由匹配成功,但 main.css 加载失败。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
别依赖相对路径,优先用绝对路径 + 构建工具接管
开发时写 src="assets/logo.svg" 看似方便,但上线到 /shop/ 或 /dashboard/ 子路径时极易断裂。更稳的做法是:
- 静态资源统一用根相对路径:
src="/assets/logo.svg"(开头/,不走 base) - API 请求统一加前缀,如 Axios 默认 baseURL 设为
'/api',由 Nginx 或代理层映射到后端 - 构建时让 Vite/Webpack 自动重写所有资源引用路径,而不是手动维护
手动写 或 href="static/" 是无效的——浏览器直接忽略,等于没设。
调试时盯死 Network 面板的 Initiator 和 Request URL
图片不显示?立刻打开开发者工具 → Network → 找失败的图片请求:
- 看 Initiator 列:如果是
HTML Parser,说明是标签触发,受影响;如果是XHR或JS,就要查 JS 里写的路径是否拼错 - 看 Request URL:对比你预期的路径,确认是多了一级、少了一级,还是被 base 偏移到了别的前缀下
- 临时禁用
标签再刷新,看是否恢复——这是判断是否为 base 导致的最快方式
路径问题不复杂,但容易忽略细节。关键不在“怎么写”,而在“谁来解析、以谁为基准”。










