Vue服務(wù)器部署刷新頁(yè)面404

問題描述

在上線vue開發(fā)的前端網(wǎng)頁(yè)部署在服務(wù)器上后，刷新頁(yè)面顯示404

原因

因?yàn)榫W(wǎng)頁(yè)上顯示的是靜態(tài)絕對(duì)路徑

而實(shí)際上服務(wù)器上是沒有改路徑的，多以導(dǎo)致刷新匯報(bào)錯(cuò)誤

解決方法

1. 在Vue框架中解決404

vue router mode 默認(rèn)為hsas，這樣的url中會(huì)帶有#，如果改成mode:'history'就能去掉#號(hào)，也可以正常訪問，但是再次率先你頁(yè)面就會(huì)出現(xiàn)404

const router = new Router({
mode: 'history'
});

將url中的#去掉，讓人很不爽

2. 修改nginx配置文件

將以下代碼放入nginx中

location / {
?? ?……
?? ?try_files $uri $uri/ /index.html; ---解決頁(yè)面刷新404問題
}　

保存并退出

• ../nginx -t -- 驗(yàn)證nginx配置文件是否正確
• ../nginx -s reload -- 重啟nginx

如果采用寶塔面板進(jìn)行部署，則修改nginx相關(guān)配置即可 

vue項(xiàng)目刷新界面出現(xiàn)404,正常點(diǎn)擊跳轉(zhuǎn)沒問題

這個(gè)原因的本質(zhì)是 history 和 hash 的區(qū)別

以 www.louhc.com/jichu/123 為例子（123為變量）

1. 直觀上的區(qū)別是：

• hash模式下，在瀏覽器地址欄里面會(huì)有: www.louhc.com/#/jichu/123 這種帶 # 號(hào)的情況,視覺上不太美觀。
• history模式下,地址欄為:www.louhc.com/jichu/123 不會(huì)出現(xiàn)帶#的情況 。

2. 致命區(qū)別

hash模式下，上線之后不會(huì)出現(xiàn)問題。

history 模式下，會(huì)出現(xiàn)一個(gè)致命的BUG，在服務(wù)器上面上線之后，點(diǎn)擊頁(yè)面跳轉(zhuǎn)沒有問題，但是一旦點(diǎn)擊刷新頁(yè)面會(huì)出現(xiàn)404錯(cuò)誤,原因是history模式下刷新界面，就等同于向服務(wù)器直接請(qǐng)求:

www.louhc.com/jichu/123。但是在服務(wù)器后端的路徑配置中壓根就沒有 /jichu/123 ，所以后端匹配不到相應(yīng)的值，就會(huì)返回404錯(cuò)誤,。有的朋友就會(huì)有疑慮，為什么在vue項(xiàng)目開發(fā)的時(shí)候不會(huì)出現(xiàn)這種問題呢？因?yàn)樵趘ue項(xiàng)目開發(fā)的時(shí)候是訪問自己的8080服務(wù)器,后端有進(jìn)行處理，在刷新界面后找不到相對(duì)路徑時(shí)，會(huì)重新渲染index.html界面，把路由的控制權(quán)交給前端，然后前端負(fù)責(zé)路由的匹配，在找到符合/jichu /123 這種格式的路由后,就會(huì)匹配成功。從而達(dá)到頁(yè)面正常顯示的情況.。

所以在線上遇到這種情況下，我們需要后端進(jìn)行相應(yīng)的配置處理，在匹配不到路徑的情況下重新渲染index.html 文件。

以下是后端如何匹配的例子:

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

本機(jī)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)
})

通過Node.js進(jìn)行表達(dá)

對(duì)于Node.js / Express，請(qǐng)考慮使用connect-history-api-fallback中間件

Internet信息服務(wù)（IIS）

安裝IIS UrlRewrite

使用以下web.config命令在網(wǎng)站的根目錄中創(chuàng)建一個(gè)文件：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
? <system.webServer>
? ? <rewrite>
? ? ? <rules>
? ? ? ? <rule name="Handle History Mode and custom 404/500" stopProcessing="true">
? ? ? ? ? <match url="(.*)" />
? ? ? ? ? <conditions logicalGrouping="MatchAll">
? ? ? ? ? ? <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
? ? ? ? ? ? <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
? ? ? ? ? </conditions>
? ? ? ? ? <action type="Rewrite" url="/" />
? ? ? ? </rule>
? ? ? </rules>
? ? </rewrite>
? </system.webServer>
</configuration>

Caddy

rewrite {
? ? regexp .*
? ? to {path} /
}

Firebase托管

將此添加到您的firebase.json：

{
? "hosting": {
? ? "public": "dist",
? ? "rewrites": [
? ? ? {
? ? ? ? "source": "**",
? ? ? ? "destination": "/index.html"
? ? ? }
? ? ]
? }
}

警告

需要注意的是：您的服務(wù)器將不再報(bào)告404錯(cuò)誤，因?yàn)樗形凑业降穆窂浆F(xiàn)在都可以處理您的index.html文件。要解決此問題，您應(yīng)該在Vue應(yīng)用程序中實(shí)施一個(gè)包羅萬象的路由以顯示404頁(yè)面：

const router = new VueRouter({
? mode: 'history',
? routes: [
? ? { path: '*', component: NotFoundComponent }
? ]
})

或者，如果您使用的是Node.js服務(wù)器，則可以通過使用服務(wù)器端的路由器來匹配輸入U(xiǎn)RL來實(shí)現(xiàn)后備，如果沒有路由匹配，則以404進(jìn)行響應(yīng)。查看Vue服務(wù)器端渲染文檔以獲取更多信息。 

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

最新評(píng)論