vue-cli腳手架打包靜態資源請求出錯的原因與解決

2019-11-19 11:23:06

字體：大中小

來源：轉載

供稿：網友

問題

vue-cli默認配置打包后部署到特定路徑下靜態資源路徑錯誤問題。
靜態資源打包使用相對路徑后css文件引入大圖片路徑錯誤問題

使用vue-cli2腳手架生成的默認打包配置文件，npm run build打包，部署項目到特定路徑下：//ip:port/test/index.html
此時訪問//ip:port/test/index.html可以正常訪問，但是引用的js和css等文件服務器響應為404，此時我們查看資源請求路徑：

http://ip:port/static/css/app.[hash].csshttp://ip:port/static/js/app.[hash].js

可以看出，上面的靜態資源訪問路徑是不正確的，我們正確的請求路徑應該是

http://ip:port/test/static/css/app.[hash].csshttp://ip:port/test/static/js/app.[hash].js

原因

可以看出導致資源加載失敗的原因是路徑錯誤，我們可以移步看看index.html文件，

<!DOCTYPE html> <html> <head> <title>project</title> <link href=/static/css/app.css rel=stylesheet> </head> <body> <div id=app></div> <script type=text/javascript src=/static/js/app.js> </script> ... </body> </html>

可以看出引入的css和js都是使用的絕對根目錄路徑，因此將項目部署到特定目錄下，其引入的資源路徑無法被正確解析。

解決

在webpack打包時，使用相對路徑來處理靜態資源，修改build中資源發布路徑配置(build/config.js);

build: { ... // Paths assetsRoot: path.resolve(__dirname, '../dist'), assetsSubDirectory: 'static', assetsPublicPath: './', ...}

將assetsPublicPath: '/'，更改為assetsPublicPath: './'，再進行打包，并將資源部署到特定路徑下，然后訪問，此時index.html可以正常訪問，同時js和css資源也可以正常加載訪問了。

css中引入assets目錄下的圖片資源出錯

我們經常這樣引用一個img圖片

background: url('static/img/bg.png');

但是打包后看到這個圖片的引用地址是這樣的。

http://ip:port/test/static/css/static/img/bg.png

可以看出css中圖片的路徑存在問題了，分析打包過程，css是在js中引入的或是寫在vue文件中的，css文件首先被less，postcss等處理，處理后會被ExtractTextPlugin處理，ExtractTextPlugin將js中的css全部抽離至app.css文件中。

解決方法一

將options.extract設置為false

options.extract: false,

關閉抽離css功能，再次打包并部署，此時你會發現沒有css文件了，css文件全部在app.js文件中，通過js將css注入到index.html文件中，此時圖片的訪問路徑是相當index.html文件的，所以可以正常訪問

解決方案二

設置ExtractTextPlugin插件中的publicPath
ExtractTextPlugin插件是為了將css從js文件中抽離出來，我們可以通過配置ExtractTextPlugin的靜態資源路徑參數來達到同樣的效果，build目錄下的utils.js文件，修改publicPath: '../../';

// Extract CSS when that option is specified// (which is the case during production build)if (!options.extract) { return ExtractTextPlugin.extract({ use: loaders, fallback: 'vue-style-loader', publicPath: '../../' })} else { return ['vue-style-loader'].concat(loaders)}

再次打包部署，發現此時的圖片訪問路徑為'../../static/img/bg.png';