Vue项目服务器部署刷新页面404问题及解决

 更新时间:2022年09月06日 08:34:31   作者:Tangctt  
这篇文章主要介绍了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 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进行表达

对于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服务器端渲染文档以获取更多信息。 

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 深入解析Vue 组件命名那些事

    深入解析Vue 组件命名那些事

    本篇文章主要介绍了深入解析Vue 组件命名那些事,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-07-07
  • electron-vue中报错Cannot use import statement outside a module的解决方案(亲测有效!)

    electron-vue中报错Cannot use import statement outside a m

    Electron 是一个使用 JavaScript、HTML 和 CSS 构建桌面应用程序的框架,下面这篇文章主要给大家介绍了关于electron-vue中报错Cannot use import statement outside a module的解决方案,需要的朋友可以参考下
    2023-02-02
  • vue路由跳转传递参数的方式总结

    vue路由跳转传递参数的方式总结

    在本篇文章和里小编给各位总结了关于vue路由跳转传递参数的三种方式以及相关代码,需要的朋友们可以学习下。
    2020-05-05
  • VUE 无限层级树形数据结构显示的实现

    VUE 无限层级树形数据结构显示的实现

    在做项目中,会遇到一些树形的数据结构,常用在左侧菜单导航,本文就介绍一下如何实现,感兴趣的可以了解一下
    2021-07-07
  • vue+node+webpack环境搭建教程

    vue+node+webpack环境搭建教程

    这篇文章主要为大家详细介绍了vue+node+webpack环境搭建教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-11-11
  • 关于uniapp的高级表单组件mosowe-form

    关于uniapp的高级表单组件mosowe-form

    这篇文章主要介绍了关于uniapp的高级表单组件mosowe-form,由于一些表单标签改来改去比较繁琐,重复性很多,且样式布局啥的几乎万变不离其中,为了偷懒,开发了mosowe-form及mosowe-table两款高级组件,需要的朋友可以参考下
    2023-04-04
  • vue正确使用watch监听属性变化方式

    vue正确使用watch监听属性变化方式

    这篇文章主要介绍了vue正确使用watch监听属性变化方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • vue--vuex详解

    vue--vuex详解

    这篇文章主要介绍了vue--vuex的详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-04-04
  • element用脚本自动化构建新组件的实现示例

    element用脚本自动化构建新组件的实现示例

    本文主要介绍了element-ui的用脚本自动化构建新组件的实现示例,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-12-12
  • Vue组件的使用教程详解

    Vue组件的使用教程详解

    组件 (Component) 是 Vue.js 最强大的功能之一。组件可以扩展 HTML 元素,封装可重用的代码。这篇文章给大家介绍了vue组件的使用,需要的朋友参考下吧
    2018-01-01

最新评论