vue-router 由hash更換為history模式

一首有、概念闡述

對于 Vue 這類漸進式前端開發(fā)框架,為了構(gòu)建 SPA(單頁面應(yīng)用)箭券,需要引入前端路由系統(tǒng),這也就是 Vue-Router 存在的意義疑枯。前端路由的核心辩块,就在于 —— 改變視圖的同時不會向后端發(fā)出請求

為了達到這一目的,瀏覽器當前提供了以下兩種支持:

  1. hash —— 即地址欄 URL 中的 # 符號(此 hash 不是密碼學(xué)里的散列運算)庆捺。
    比如這個 URL:[http://www.abc.com/#/hello](http://www.abc.com/#/hello)古今,hash 的值為 #/hello。它的特點在于:hash 雖然出現(xiàn)在 URL 中滔以,
    但不會被包括在 HTTP 請求中,對后端完全沒有影響氓拼,因此改變 hash 不會重新加載頁面你画。
  2. history —— 利用了 HTML5 History Interface 中新增的 pushState()replaceState() 方法。(需要特定瀏覽器支持)這兩個方法應(yīng)用于瀏覽器的歷史記錄棧桃漾,在當前已有的 back坏匪、forwardgo 的基礎(chǔ)之上撬统,它們提供了對歷史記錄進行修改的功能适滓。只是當它們執(zhí)行修改時,雖然改變了當前的 URL恋追,但瀏覽器不會立即向后端發(fā)送請求凭迹。

因此,hash 模式和 history 模式都屬于瀏覽器自身的特性苦囱,Vue-Router 只是利用了這兩個特性(通過調(diào)用瀏覽器提供的接口)來實現(xiàn)前端路由嗅绸。

二、為什么變遷

一般場景下撕彤,hash 和 history 都可以實現(xiàn)路由跳轉(zhuǎn)鱼鸠,默認是hash模式。那么為什么要變遷呢羹铅?理由如下:

1蚀狰、顏值
“#”符號夾雜在 URL 里看起來確實有些不太美麗,所以要把#去掉职员。

2麻蹋、跨域問題
在項目開發(fā)過程中,路由跳轉(zhuǎn)帶#的url請求和普通接口url請求的混用廉邑,產(chǎn)生了令人頭疼的跨域問題哥蔚。需要將url中的“#”去掉。

3蛛蒙、其他
根據(jù) Mozilla Develop Network 的介紹糙箍,調(diào)用 history.pushState() 相比于直接修改 hash,存在以下優(yōu)勢:

  • pushState() 設(shè)置的新 URL 可以是與當前 URL 同源的任意 URL牵祟;而 hash 只可修改 # 后面的部分深夯,因此只能設(shè)置與當前 URL 同文檔的 URL;
  • pushState() 設(shè)置的新 URL 可以與當前 URL 一模一樣,這樣也會把記錄添加到棧中咕晋;而 hash設(shè)置的新值必須與原來不一樣才會觸發(fā)動作將記錄添加到棧中雹拄;
  • pushState() 通過 stateObject 參數(shù)可以添加任意類型的數(shù)據(jù)到記錄中;而 hash 只可添加短字符串掌呜;
  • pushState() 可額外設(shè)置 title 屬性供后續(xù)使用滓玖。

當然,history 也不是樣樣都好质蕉。SPA 雖然在瀏覽器里游刃有余势篡,但真要通過 URL 向后端發(fā)起 HTTP 請求時,兩者的差異就來了模暗。尤其在用戶手動輸入 URL 后回車禁悠,或者刷新(重啟)瀏覽器的時候。

  • hash 模式下兑宇,僅 hash 符號之前的內(nèi)容會被包含在請求中碍侦,如 [http://www.abc.com](http://www.abc.com/),因此對于后端來說隶糕,即使沒有做到對路由的全覆蓋瓷产,也不會返回 404 錯誤。
  • history 模式下若厚,前端的 URL 必須和實際向后端發(fā)起請求的 URL 一致拦英,如 [http://www.abc.com/book/id](http://www.abc.com/book/id)。如果后端缺少對 /book/id 的路由處理测秸,將返回 404 錯誤疤估。Vue-Router 官網(wǎng)里如此描述:“不過這種模式要玩好,還需要后臺配置支持……所以呢霎冯,你要在服務(wù)端增加一個覆蓋所有情況的候選資源:如果 URL 匹配不到任何靜態(tài)資源铃拇,則應(yīng)該返回同一個 index.html 頁面,這個頁面就是你 app 依賴的頁面沈撞】独螅”

三、如何變遷

1缠俺、前端修改
在創(chuàng)建VueRouter對象的地方添加mode:'history'屬性显晶。

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

注意,如果前端文件不是部署在服務(wù)器的根目錄下壹士,還要修改另外幾個地方磷雇。
假如部署在Project文件夾下,在new VueRouter對象的時候躏救,要添加一個base屬性唯笙,如下所示:

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

另外螟蒸,在config-->index.js文件中,將assetsPublicPath屬性也改為/Project/崩掘,如下所示:

 build: {
     // Template for index.html
     index: path.resolve(__dirname, '../dist/index.html'),
     // Paths
     assetsRoot: path.resolve(__dirname, '../dist'),
     assetsSubDirectory: 'static',
     assetsPublicPath: '/Project/',
} 

2七嫌、后端配置

Apache

  <IfModule mod_rewrite.c>
      RewriteEngine On
      RewriteBase /
      RewriteRule ^index\.html$ - [L]
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteRule . /index.html [L]
  </IfModule>

除了 mod_rewrite,也可以使用 FallbackResource苞慢。

nginx

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

原生 Node.js

  const http = require('http')
  const fs = require('fs')
  const httpPort = 80
  http.createServer((req, res) => {
     fs.readFile('index.htm', 'utf-8', (err, content) => {
        if (err) {
           console.log('We cannot open "index.htm" file.')
        }
        res.writeHead(200, {
           'Content-Type': 'text/html; charset=utf-8'
        })
        res.end(content)
      })
  }).listen(httpPort, () => {
      console.log('Server listening on: http://localhost:%s', httpPort)
  })

四诵原、變遷后帶來的問題及解決辦法

變遷為history之后,url中不再帶“#”符號枉疼,美觀了皮假,也能解決跨域的問題了。但是引起了新的問題骂维。
1、vue頁面中的href贺纲、window.open()等使用相對路徑時航闺,指向的鏈接自動變的不對了。
解決辦法:

  • 使用絕對路徑猴誊,但是使用絕對路徑比較麻煩潦刃,不推薦。
  • 查看錯誤鏈接懈叹,和正確的鏈接對比乖杠,對了或者少了什么,然后進行修正澄成。
參考鏈接:

https://router.vuejs.org/zh/guide/essentials/history-mode.html
https://segmentfault.com/q/1010000010340823/a-1020000011352255

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末胧洒,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子墨状,更是在濱河造成了極大的恐慌卫漫,老刑警劉巖,帶你破解...
    沈念sama閱讀 221,430評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件肾砂,死亡現(xiàn)場離奇詭異列赎,居然都是意外死亡,警方通過查閱死者的電腦和手機镐确,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,406評論 3 398
  • 文/潘曉璐 我一進店門包吝,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人源葫,你說我怎么就攤上這事诗越。” “怎么了臼氨?”我有些...
    開封第一講書人閱讀 167,834評論 0 360
  • 文/不壞的土叔 我叫張陵掺喻,是天一觀的道長。 經(jīng)常有香客問我,道長感耙,這世上最難降的妖魔是什么褂乍? 我笑而不...
    開封第一講書人閱讀 59,543評論 1 296
  • 正文 為了忘掉前任,我火速辦了婚禮即硼,結(jié)果婚禮上逃片,老公的妹妹穿的比我還像新娘。我一直安慰自己只酥,他們只是感情好褥实,可當我...
    茶點故事閱讀 68,547評論 6 397
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著裂允,像睡著了一般损离。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上绝编,一...
    開封第一講書人閱讀 52,196評論 1 308
  • 那天僻澎,我揣著相機與錄音,去河邊找鬼十饥。 笑死窟勃,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的逗堵。 我是一名探鬼主播秉氧,決...
    沈念sama閱讀 40,776評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼蜒秤!你這毒婦竟也來了汁咏?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,671評論 0 276
  • 序言:老撾萬榮一對情侶失蹤垦藏,失蹤者是張志新(化名)和其女友劉穎梆暖,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體掂骏,經(jīng)...
    沈念sama閱讀 46,221評論 1 320
  • 正文 獨居荒郊野嶺守林人離奇死亡轰驳,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,303評論 3 340
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了弟灼。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片级解。...
    茶點故事閱讀 40,444評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖田绑,靈堂內(nèi)的尸體忽然破棺而出勤哗,到底是詐尸還是另有隱情,我是刑警寧澤掩驱,帶...
    沈念sama閱讀 36,134評論 5 350
  • 正文 年R本政府宣布芒划,位于F島的核電站冬竟,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏民逼。R本人自食惡果不足惜泵殴,卻給世界環(huán)境...
    茶點故事閱讀 41,810評論 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望拼苍。 院中可真熱鬧笑诅,春花似錦、人聲如沸疮鲫。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,285評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽俊犯。三九已至妇多,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間燕侠,已是汗流浹背砌梆。 一陣腳步聲響...
    開封第一講書人閱讀 33,399評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留贬循,地道東北人。 一個月前我還...
    沈念sama閱讀 48,837評論 3 376
  • 正文 我出身青樓桃序,卻偏偏與公主長得像杖虾,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子媒熊,可洞房花燭夜當晚...
    茶點故事閱讀 45,455評論 2 359

推薦閱讀更多精彩內(nèi)容