vue-cli腳手架打包的靜態資源請求出錯

時間 2019-12-16

原文原文鏈接

vue-cli腳手架打包的靜態資源請求出錯

問題

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

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

http://ip:port/static/css/app.[hash].css
http://ip:port/static/js/app.[hash].js
複製代碼

能夠看出，上面的靜態資源訪問路徑是不正確的，咱們正確的請求路徑應該是css

http://ip:port/test/static/css/app.[hash].css
http://ip:port/test/static/js/app.[hash].js
複製代碼

緣由

能夠看出致使資源加載失敗的緣由是路徑錯誤，咱們能夠移步看看index.html文件，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都是使用的絕對根目錄路徑，所以將項目部署到特定目錄下，其引入的資源路徑沒法被正確解析。vue

解決

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

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

將assetsPublicPath: '/'，更改成assetsPublicPath: './'，再進行打包，並將資源部署到特定路徑下，而後訪問，此時index.html能夠正常訪問，同時js和css資源也能夠正常加載訪問了。webpack

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

咱們常常這樣引用一個img圖片web

background: url('static/img/bg.png');
複製代碼

可是打包後看到這個圖片的引用地址是這樣的。vue-cli

http://ip:port/test/static/css/static/img/bg.png
複製代碼

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

解決方法一

將options.extract設置爲falsebash

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';