Vue Router history模式的配置方法及其原理

vue-router分為 hash和 history模式，前者為其默認(rèn)模式，url的表現(xiàn)形式為 http://yoursite.com#home，比較難看。后者的url表現(xiàn)形式為 http://yoursite.com/home，比較美觀。

但如果要使用 history模式，我們需要在后端進(jìn)行額外配置。本文將討論如何配置以及為什么要這樣配置。

history模式的配置方法

我們來看看官方文檔是教我們?cè)趺磁渲玫模篐TML5 History 模式。

首先要將 mode設(shè)置為 history：

const router = new VueRouter({
 mode: 'history',
 routes: [...]
})

然后設(shè)置后端（這里采用的nginx）：

location / {
 try_files $uri $uri/ /index.html;
}

然后就......沒了！顯然官方的教程講的比較簡(jiǎn)略，并且我們參照這個(gè)教程實(shí)際上還是會(huì)遇到一些問題。

history模式的配置實(shí)踐及原理

強(qiáng)烈建議：閱讀這部分之前，先看一下nginx的這部分文檔和 這部分文檔。

既然官方文檔教我們這樣做了，我們就按照它說的來實(shí)踐一下。

只配置前端的情況

首先，我們將 mode設(shè)置為 history，但不配置后端。然后，假如我們的路由是長(zhǎng)這個(gè)樣子的：

const routes = [
  {path: '/home', component: Home},
  {path: '/', redirect: '/home'}
];

我們用nginx部署項(xiàng)目，然后在地址欄輸入 http://localhost:8080（這里配置的端口是8080），你會(huì)發(fā)現(xiàn)地址欄之后會(huì)變?yōu)?http://localhost:8080/home，并且 看起來一切正常， 似乎路由也可以正常切換而不會(huì)發(fā)生其他問題（實(shí)際上會(huì)發(fā)生問題，后面會(huì)進(jìn)行討論）?？雌饋砗孟癫恍枰垂倬W(wǎng)告訴我們的那樣配置后端也能實(shí)現(xiàn) history模式，但如果你直接在地址欄輸入 http://localhost:8080/home，你會(huì)發(fā)現(xiàn)你獲得了一個(gè)404頁面。

那么 http://localhost:8080為什么可以（部分）正常顯示呢？道理其實(shí)很簡(jiǎn)單，你訪問 http://localhost:8080時(shí)，靜態(tài)服務(wù)器（這里是nginx）會(huì)默認(rèn)去目標(biāo)目錄（這里為 location中 root所指定的目錄）下尋找 index.html（這是nginx在端口后沒有額外路徑時(shí)的默認(rèn)行為），目標(biāo)目錄下有這個(gè)文件嗎？有！然后靜態(tài)服務(wù)器返回給你這個(gè)文件，配合 vue-router進(jìn)行轉(zhuǎn)發(fā)，自然可以（部分）正常顯示。

但如果直接訪問 http://localhost:8080/home，靜態(tài)服務(wù)器會(huì)去目標(biāo)目錄下尋找 home文件，目標(biāo)目錄下有這個(gè)文件嗎？沒有！所以自然就404了。

配置后端

為了達(dá)到直接訪問 http://localhost:8080/home也可以成功的目的，我們需要對(duì)后端（這里即nginx）進(jìn)行一些配置。

首先想想，要怎樣才能達(dá)到這個(gè)目的呢？

在傳統(tǒng)的 hash模式中（ http://localhost:8080#home），即使不需要配置，靜態(tài)服務(wù)器始終會(huì)去尋找 index.html并返回給我們，然后 vue-router會(huì)獲取 #后面的字符作為參數(shù)，對(duì)前端頁面進(jìn)行變換。

類比一下，在 history模式中，我們所想要的情況就是：輸入 http://localhost:8080/home，但最終返回的也是 index.html，然后 vue-router會(huì)獲取 home作為參數(shù)，對(duì)前端頁面進(jìn)行變換。那么在nginx中，誰能做到這件事呢？答案就是 try_files。

首先看一下try_files的語法： try_files file ... uri;

然后看一下官方文檔對(duì)它的介紹：

Checks the existence of files in the specified order and uses the first found file for request processing; the processing is performed in the current context. The path to a file is constructed from the file parameter according to the root and alias directives. It is possible to check directory's existence by specifying a slash at the end of a name, e.g. “$uri/”. If none of the files were found, an internal redirect to the uri specified in the last parameter is made.

大意就是它會(huì)按照 try_files后面的參數(shù)依次去匹配 root中對(duì)應(yīng)的文件或文件夾。如果匹配到的是一個(gè)文件，那么將返回這個(gè)文件；如果匹配到的是一個(gè)文件夾，那么將返回這個(gè)文件夾中 index指令指定的文件。最后一個(gè) uri參數(shù)將作為前面沒有匹配到的fallback。（注意 try_files指令至少需要兩個(gè)參數(shù)）

拿我自己的網(wǎng)站舉個(gè)例子：

location / { 
    root      /data/www/rf-blog-web; 
    index      index.html; 
    try_files    $uri $uri/ /index.html; 
}

$uri是nginx中的變量，比如我訪問的網(wǎng)址是 http://localhost:8080/home，那么它就代表的 /home。

在 rf-blog-web這個(gè)目錄中，沒有子目錄，只有一個(gè) index.html和一些壓縮后的名稱是hash值的.js文件。當(dāng)我們請(qǐng)求 http://localhost:8080/home這個(gè)地址時(shí)，首先查找有無 home這個(gè)文件，沒有；再查找有無 home目錄，也沒有。所以最終會(huì)定位到第三個(gè)參數(shù)從而返回 index.html，按照這個(gè)規(guī)則，所有路由里的url路徑最后都會(huì)定位到 index.html。 vue-router再獲取參數(shù)進(jìn)行前端頁面的變換，至此，我們已經(jīng)可以通過 http://localhost:8080/home這個(gè)地址進(jìn)行成功地訪問了。

而 $uri這個(gè)參數(shù)的作用其實(shí)是匹配那些.js文件用的，而 $uri/在這個(gè)例子中并沒有多大用，實(shí)際上是可以去掉的。

history模式下可能會(huì)遇到的問題及解決方案

在將我的項(xiàng)目（在路由中用了懶加載）改為 history模式的過程中，有時(shí)候發(fā)現(xiàn)會(huì)出現(xiàn)chunk加載出錯(cuò)的情況，打開chrome的network發(fā)現(xiàn)那個(gè)chunk加載404了，是因?yàn)檎?qǐng)求的url中多了一層路徑。我在這里發(fā)現(xiàn)了解決方案。

LinusBorg說，因?yàn)樵?history模式中切換路由時(shí)，我們是真正改變了頁面的url路徑，所以webpack的runtime會(huì)認(rèn)為它位于 example.com/some/path。如果 publicPath是設(shè)置的相對(duì)路徑，那么webpack加載chunk時(shí)可能會(huì)變成 example.com/some/path/static/js/3.js這樣的路徑，然而chunk的真正路徑是 example.com/static/js/3.js，所以我們需要將 publicPath設(shè)置為絕對(duì)路徑（ publicPath: '/'）來解決這個(gè)問題。

總結(jié)

以上所述是小編給大家介紹的Vue Router history模式的配置方法及其原理，希望對(duì)大家有所幫助，如果大家有任何疑問請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)億速云網(wǎng)站的支持！