Vue history模式刷新頁面404問題及解決
為什么會出現(xiàn)404
我們先來看一下我們給到后端的dist文件

可以看到dist下只有一個 index.html 文件及一些靜態(tài)資源,這個是因為Vue是單頁應用(SPA),只有一個index.html作為入口文件,其它的路由都是通過JS來進行跳轉(zhuǎn)
接著我們再來分析一下后端 nginx 的配置
server {
// 監(jiān)聽80端口
listen 80;
// 定義你的站點名稱
server_name website.com;
// 根據(jù)請求 URI 設置配置
location / {
// 站點根目錄,這里為 vue 構建出來的 dist 目錄
root /www/dist;
// 站點初始頁為index.html 或 index.htm
index index.html index.htm;
}
}我們現(xiàn)在可以根據(jù) nginx 配置得出,當我們在地址欄輸入 website.com 時,這時會打開我們 dist 目錄下的 index.html 文件,然后我們在跳轉(zhuǎn)路由進入到 website.com/login
關鍵在這里,當我們在 website.com/login 頁執(zhí)行刷新操作,nginx location 是沒有相關配置的,所以就會出現(xiàn) 404 的情況
為什么hash模式下沒有問題
router hash 模式我們都知道是用符號#表示的,如 website.com/#/login, hash 的值為 #/login
它的特點在于:hash 雖然出現(xiàn)在 URL 中,但不會被包括在 HTTP 請求中,對服務端完全沒有影響,因此改變 hash 不會重新加載頁面
hash 模式下,僅 hash 符號之前的內(nèi)容會被包含在請求中,如 website.com/#/login 只有 website.com 會被包含在請求中 ,因此對于服務端來說,即使沒有配置location,也不會返回404錯誤
單頁應用(SPA)概念
我們前面有提到單頁應用,那什么是單頁應用呢?
單頁應用
單頁應用(single-page application),縮寫SPA 是一種網(wǎng)絡應用程序或網(wǎng)站的模型,它通過動態(tài)重寫當前頁面來與用戶交互,而非傳統(tǒng)的從服務器重新加載整個新頁面。
這種方法避免了頁面之間切換打斷用戶體驗,使應用程序更像一個桌面應用程序。在單頁應用中,所有必要的代碼(HTML、JavaScript和CSS)都通過單個頁面的加載而檢索,或者根據(jù)需要(通常是為響應用戶操作)動態(tài)裝載適當?shù)馁Y源并添加到頁面。
盡管可以用位置散列或HTML5歷史API來提供應用程序中單獨邏輯頁面的感知和導航能力,但頁面在過程中的任何時間點都不會重新加載,也不會將控制轉(zhuǎn)移到其他頁面
大白話來講:
一個杯子,早上裝的牛奶,中午裝的是開水,晚上裝的是茶,我們可以發(fā)現(xiàn),變的始終是內(nèi)容,而容器還是那個容器
當然,每種技術都有其利弊,單頁應用也是如此
利:
- 無刷新體驗,這個應該是最顯著的有點,由于路由分發(fā)直接在瀏覽器端完成,頁面是不刷新,對用戶的響應非常及時,因此提升了用戶體驗
- 完全的前端組件化,前端開發(fā)不再以頁面為單位,更多地采用組件化的思想,代碼結構和組織方式更加規(guī)范化,便于修改和調(diào)整
弊:
- 首屏較長,要在一個頁面上為用戶提供產(chǎn)品的所有功能,在這個頁面加載的時候,首先要加載大量的靜態(tài)資源,這個加載時間相對比較長
- 不利于 SEO,單頁頁面,數(shù)據(jù)在前端渲染,就意味著沒有 SEO,或者需要使用變通的方案
Router的實現(xiàn)
為了讓大家加深大家對 Router 的理解,這里我們實現(xiàn)一個最簡潔的 Router
- hash 模式
核心通過監(jiān)聽url中的hash來進行路由跳轉(zhuǎn)
// 定義 Router
class Router {
constructor () {
this.routes = {}; // 存放路由path及callback
this.currentUrl = '';
// 監(jiān)聽路由change調(diào)用相對應的路由回調(diào)
window.addEventListener('load', this.refresh, false);
window.addEventListener('hashchange', this.refresh, false);
}
route(path, callback){
this.routes[path] = callback;
}
push(path) {
this.routes[path] && this.routes[path]()
}
}
// 使用 router
window.miniRouter = new Router();
miniRouter.route('/', () => console.log('page1'))
miniRouter.route('/page2', () => console.log('page2'))
miniRouter.push('/') // page1
miniRouter.push('/page2') // page2- history 模式
history 模式核心借用 HTML5 history api,api 提供了豐富的 router 相關屬性
先了解一個幾個相關的api
- history.pushState 瀏覽器歷史紀錄添加記錄
- history.replaceState 修改瀏覽器歷史紀錄中當前紀錄
- history.popState 當 history 發(fā)生變化時觸發(fā)
// 定義 Router
class Router {
constructor () {
this.routes = {};
this.listerPopState()
}
init(path) {
history.replaceState({path: path}, null, path);
this.routes[path] && this.routes[path]();
}
route(path, callback){
this.routes[path] = callback;
}
push(path) {
history.pushState({path: path}, null, path);
this.routes[path] && this.routes[path]();
}
listerPopState () {
window.addEventListener('popstate' , e => {
const path = e.state && e.state.path;
this.routers[path] && this.routers[path]()
})
}
}
// 使用 Router
window.miniRouter = new Router();
miniRouter.route('/', ()=> console.log('page1'))
miniRouter.route('/page2', ()=> console.log('page2'))
// 跳轉(zhuǎn)
miniRouter.push('/page2') // page2解決404
看到這里我相信大部分同學都能想到怎么解決問題了,
產(chǎn)生問題的本質(zhì)是因為我們的路由是通過JS來執(zhí)行視圖切換的,
當我們進入到子路由時刷新頁面,web容器沒有相對應的頁面此時會出現(xiàn)404
所以我們只需要配置將任意頁面都重定向到 index.html,把路由交由前端處理
還是以 nginx 為例,更多版本的大家可以前往https://router.vuejs.org/zh/guide/essentials/history-mode.html 查看
location / {
try_files $uri $uri/ /index.html;
}這里有一個小細節(jié),如果出現(xiàn)真的 404 頁面了呢?比如 website.com/notfound
因為這么做以后,你的服務器就不再返回 404 錯誤頁面,因為對于所有路徑都會返回 index.html 文件。為了避免這種情況,你應該在 Vue 應用里面覆蓋所有的路由情況,然后在給出一個 404 頁面
const router = new VueRouter({
mode: 'history',
routes: [
{ path: '*', component: NotFoundComponent }
]
})總結
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
相關文章
vue3+ts+Vuex中使用websocket協(xié)議方式
這篇文章主要介紹了vue3+ts+Vuex中使用websocket協(xié)議方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-10-10
尤雨溪開發(fā)vue?dev?server理解vite原理
這篇文章主要為大家介紹了尤雨溪開發(fā)的玩具vite,vue-dev-server來理解vite原理,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-07-07
Vue-router結合transition實現(xiàn)app前進后退動畫切換效果的實例
下面小編就為大家?guī)硪黄猇ue-router結合transition實現(xiàn)app前進后退動畫切換效果的實例。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-10-10
vue3 中使用vue?img?cutter?圖片裁剪插件的方法
這篇文章主要介紹了vue3 中使用vue?img?cutter?圖片裁剪插件的方法,首先安裝依賴,構建 components/ImgCutter.vue 組件,需要的朋友可以參考下2024-05-05
基于 Vue.js 之 iView UI 框架非工程化實踐記錄(推薦)
為了快速體驗 MVVM 模式,我選擇了非工程化方式來起步,并選擇使用 Vue.js,以及基于它構建的 iView UI 框架。本文給大家分享基于 Vue.js 之 iView UI 框架非工程化實踐記錄,需要的朋友參考下吧2017-11-11

