本文主要解决
.vue-cli 默认配置打包后部署至特定路径下静态资源路径错误问题;
. 静态资源打包使用相对路径后 CSS 文件引入大图片路径错误问题
1 问题
vue-cli 脚手架生成的默认打包配置文件情况下运行 npm run build 打包后, 部署项目至特定路径下: 如:
//ip:port/public/springActivity/
此时访问:
http://ip:port/public/springActivity/index.html
index.html 可以正常访问, 但是引用的 js,css 等文件服务器响应均为 404, 查看引入的资源路径如下:
- http://ip:port/static/css/app.cea07642cd24c0d7a5c4b9b7afc7ff64.css
- http://ip:port/static/js/app.815851e87b083afb82bf.js
2 分析
由上可以看出是资源打包路径有误, 打包后的资源使用了绝对根目录路径, 因此将项目部署到特定目录下, 其引入的资源路径无法被正确解析
3 解决
在打包时需要使用相对路径来处理静态资源, 更改 build 中资源发布路径配置 (config/index.js, build 对象):
将 assetsPublicPath: '/' 改为 assetsPublicPath: './',
再次打包, 并将资源部署到特定路径下, 然后访问:
此时 index.html 可以正常访问, 同时 js 和 css 资源也可以正常访问, 但是 css 中引入的 assets 目录下的大图片资源出错了 (服务端 404)
4. 再分析
查看引入的图片资源路径如下:
http://ip:port/public/springActivity/static/css/static/img/question_bg.61a2825.png
实际项目中资源路径如下:
- index.html
- static/
- |--js/
- |--*.js
- |--css/
- |--*.css
- |--img/
- |--*.png
很明显图片引入路径有误分析图片引入路径, 发现路径均多了 "/static/css" 两层目录, 猜测是 css 目录下的 css 文件引入图片路径为 "/static/img/question_bg.61a2825.png" , 查看 css 文件, css 中引入图片路径如下:
background:url(static/img/question_bg.61a2825.png)
5 在解决
css 文件中路径存在问题, 肯定又是打包哪个环节资源路径没有配置好, 分析打包过程, css 是在 js 中引入的或是写在 vue 文件中的, css 文件首先被 less,postcss 等处理, 处理后会被 ExtractTextPlugin 处理, ExtractTextPlugin 将 js 中的 css 全部抽离至 app.css 文件中
首先将 options.extract 设为 false, 关闭抽离 css 功能, 再次打包并部署至特定目录, 访问: http://ip:port/public/springActivity/index.html, 啪, 页面正常显示, 大公即将告成
分析打包后的文件, 发现没有了 css 文件, 发现 css 文件全部在 app.js 文件中; 通过 js 将 css 注入 index.html 文件中, 因此 css 文件中引入的图片资源路径应该是相对于 index.html 文件路径的, 即:"static/img/question_bg.61a2825.png", 这与下面 css 文件中的图片资源路径一致, 因此图片能够被正常访问
background:url(static/img/question_bg.61a2825.png)
现在很确定知道问题出在哪了, 即: ExtractTextPlugin 抽离 css 文件时没有转换资源引入路径, 导致 app.css 引入了相对 app.css 目录为 "static/img/ .png" 的静态资源, 该路径相对 index.html 即为: static/css/static/img/ .png
因此使用 ExtractTextPlugin 插件时还需要配置静态资源路径参数, 通过查询资料, 得知可以通过添加 publicPath:"../../" 解决该问题:
- if (options.extract) {
- return ExtractTextPlugin.extract({
- use: loaders,
- fallback: 'vue-style-loader',
- publicPath: "../../" // 添加
- })
- }
打包部署到特定目录下后访问 index.html 文件, 页面一切正常, app.css 文件正常引入, 图片资源也正常引入, 查看 app.css 文件引入图片资源方式如下:
background:url(../../static/img/question_bg.61a2825.png
publicPath 配置后, css 文件中引入的图片文件路径前添加了该路径配置;
publicPath 属性值为打包后的 app.css 文件至 index.html 文件的相对路径
图片资源也可以直接放在 vue-cli 生成的 static 目录下规避上述问题, 但是通过这种方式图片名称中无法增加 md5 字符串, 不利于版本控制
来源: http://www.jb51.net/article/134448.htm