Vue项目服务器部署后刷新页面频繁出现404错误怎么办？

本文共计1162个文字，预计阅读时间需要5分钟。

目录 + Vue服务器部署刷新页面404问题描述 + 原因 + 解决方法 + Vue项目刷新界面出现404，正常点击跳转无问题 + Vue服务器部署刷新页面404问题描述 + 在线上Vue开发的前端网页部署在服务器上后，刷新页面出现404

目录

• Vue服务器部署刷新页面404
• 问题描述
• 原因
• 解决方法
• vue项目刷新界面出现404,正常点击跳转没问题

Vue服务器部署刷新页面404

问题描述

在上线vue开发的前端网页部署在服务器上后，刷新页面显示404

原因

因为网页上显示的是静态绝对路径

而实际上服务器上是没有改路径的，多以导致刷新汇报错误

解决方法

1. 在Vue框架中解决404

vue router mode 默认为hsas，这样的url中会带有#，如果改成mode:'history'就能去掉#号，也可以正常访问，但是再次率先你页面就会出现404

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

将url中的#去掉，让人很不爽

2. 修改nginx配置文件

将以下代码放入nginx中

location / {     ……     try_files $uri $uri/ /index.html; ---解决页面刷新404问题 }　

保存并退出

• ../nginx -t -- 验证nginx配置文件是否正确
• ../nginx -s reload -- 重启nginx

如果采用宝塔面板进行部署，则修改nginx相关配置即可

vue项目刷新界面出现404,正常点击跳转没问题

这个原因的本质是 history 和 hash 的区别

以 www.louhc.com/jichu/123 为例子（123为变量）

1. 直观上的区别是：

• hash模式下，在浏览器地址栏里面会有: www.louhc.com/#/jichu/123 这种带 # 号的情况,视觉上不太美观。
• history模式下,地址栏为:www.louhc.com/jichu/123 不会出现带#的情况 。

2. 致命区别

hash模式下，上线之后不会出现问题。

history 模式下，会出现一个致命的BUG，在服务器上面上线之后，点击页面跳转没有问题，但是一旦点击刷新页面会出现404错误,原因是history模式下刷新界面，就等同于向服务器直接请求:

www.louhc.com/jichu/123。但是在服务器后端的路径配置中压根就没有 /jichu/123 ，所以后端匹配不到相应的值，就会返回404错误,。有的朋友就会有疑虑，为什么在vue项目开发的时候不会出现这种问题呢？因为在vue项目开发的时候是访问自己的8080服务器,后端有进行处理，在刷新界面后找不到相对路径时，会重新渲染index.html界面，把路由的控制权交给前端，然后前端负责路由的匹配，在找到符合/jichu /123 这种格式的路由后,就会匹配成功。从而达到页面正常显示的情况.。

所以在线上遇到这种情况下，我们需要后端进行相应的配置处理，在匹配不到路径的情况下重新渲染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; }

本机Node.js

const localhost:%s', httpPort) })

通过Node.js进行表达

对于Node.js / Express，请考虑使用connect-history-api-fallback中间件

Internet信息服务（IIS）

安装IIS UrlRewrite

使用以下web.config命令在网站的根目录中创建一个文件：

<?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"       }     ]   } }

警告

需要注意的是：您的服务器将不再报告404错误，因为所有未找到的路径现在都可以处理您的index.html文件。要解决此问题，您应该在Vue应用程序中实施一个包罗万象的路由以显示404页面：

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

或者，如果您使用的是Node.js服务器，则可以通过使用服务器端的路由器来匹配输入URL来实现后备，如果没有路由匹配，则以404进行响应。查看Vue服务器端渲染文档以获取更多信息。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持易盾网络。