解决Vue应用中遇到路由刷新后出现 404 错误

解释:

Vue 应用中遇到路由刷新后出现 404 错误,通常是因为 Vue 应用是个单页应用(SPA),它通过 Vue Router 管理路由,通过 HTML5 History Mode 实现页面导航无需重新加载页面。当直接访问非首页的路由或者刷新页面时,服务器会尝试寻找对应的真实物理路径,找不到就会返回 404 错误。

解决方法:

  1. 服务器配置:需要配置服务器,使其可以正确处理所有路由请求,并返回同一个index.html页面。

对于不同的服务器,配置方法如下:

对于 Apache: 在服务器的配置文件(通常是.htaccess文件)中添加以下规则:
*

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

对于 Nginx: 在 Nginx 配置文件中添加如下配置:
*

复制代码
  location / {
    try_files $uri $uri/ /index.html;
  }

对于 Node.js: 如果你使用的是 Node.js 的 Express 服务器,可以添加以下路由来捕获所有路由请求并返回index.html

复制代码
  app.get('*', (req, res) => {
    res.sendFile(path.resolve(__dirname, 'public', 'index.html'));
  });
  • 使用 Hash Mode:另一种方法是使用 Vue Router 的 Hash Mode,它不需要服务器端的特别配置。在 Vue Router 中设置mode: 'hash'即可启用。

  • 例如,在 Vue 应用的入口文件main.js中配置 Vue Router:

复制代码
  import Vue from 'vue';
  import VueRouter from 'vue-router';
  import App from './App.vue';
   
  Vue.use(VueRouter);
   
  const router = new VueRouter({
    mode: 'hash', // 启用 hash mode
    routes: [
      // 定义路由
    ]
  });
   
  new Vue({
    router,
    render: h => h(App)
  }).$mount('#app');

选择合适的方法进行配置,即可解决 Vue 应用在路由刷新时出现的 404 错误。

相关推荐
Highcharts.js21 小时前
适合报表系统的可视化图表|Highcharts支持直接导出PNG和PDF
javascript·数据库·react.js·pdf
ZC跨境爬虫1 天前
使用Claude Code开发校园交友平台前端UI全记录(含架构、坑点、登录逻辑及算法)
前端·ui·架构
慧一居士1 天前
Vue项目中,何时使用布局、子组件嵌套、插槽 对应的使用场景,和完整的使用示例
前端·vue.js
叫我一声阿雷吧1 天前
JS 入门通关手册(35):执行上下文、调用栈与作用域链深度解析
javascript·作用域链·js进阶·执行上下文·调用栈·变量提升·闭包原理
Можно1 天前
uni.request 和 axios 的区别?前端请求库全面对比
前端·uni-app
M ? A1 天前
解决 VuReact 中 ESLint 规则冲突的完整指南
前端·react.js·前端框架
Jave21081 天前
实现全局自定义loading指令
前端·vue.js
奔跑的呱呱牛1 天前
CSS Grid 布局参数详解(超细化版)+ 中文注释 Demo
前端·css·grid
木斯佳1 天前
前端八股文面经大全:影刀AI前端一面(2026-04-01)·面经深度解析
前端·人工智能·沙箱·tool·ai面经
Amumu121381 天前
Js:正则表达式(一)
开发语言·javascript·正则表达式