vue项目页面刷新后报404的解决方法

 更新时间:2025年12月07日 09:29:36   作者:悟能不能悟  
vue项目页面正常访问,但是刷新后报404,这种情况通常是由于 前端路由​ 和 浏览器直接访问​ 的差异导致的,主要有以下几个原因和解决方案,下面我们就来详细介绍一下吧

这种情况通常是由于 前端路由​ 和 浏览器直接访问​ 的差异导致的。主要有以下几个原因和解决方案:

主要原因

1. 路由模式问题(History vs Hash)

// 如果使用 history 模式,需要服务器配置
const router = new VueRouter({
  mode: 'history', // 需要服务器支持
  // mode: 'hash',  // 直接访问不会有问题,但URL有#号
  routes: [...]
})

2. 服务器配置问题

当直接输入URL时,浏览器会向服务器请求该路径,如果服务器没有正确配置,会返回404。

解决方案

方案1:配置服务器重定向

Nginx 配置:

location / {
  try_files $uri $uri/ /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>

方案2:使用 Hash 模式

const router = new VueRouter({
  mode: 'hash', // URL会包含 #/path
  routes: [...]
})

方案3:开发环境配置(webpack-dev-server)

vue.config.js中:

module.exports = {
  devServer: {
    historyApiFallback: true,
    // 或者更详细的配置
    historyApiFallback: {
      rewrites: [
        { from: /.*/, to: '/index.html' }
      ]
    }
  }
}

检查步骤

确认当前路由模式:

console.log(router.mode) // 查看是 history 还是 hash

检查路由配置:

// 确保路由正确定义
const routes = [
  {
    path: '/your-path', // 你访问的路径
    component: YourComponent,
    name: 'YourRoute'
  }
]

验证路由跳转:

<template>
  <!-- 这两种方式应该都能工作 -->
  <router-link to="/your-path">跳转</router-link>
  <button @click="$router.push('/your-path')">编程式导航</button>
</template>

实际示例

假设你的路由配置:

// router.js
const routes = [
  {
    path: '/user/:id',
    component: UserProfile,
    name: 'user'
  }
]

直接访问问题:

  • ❌ 直接输入:http://yoursite.com/user/123(可能404)
  • ✅ 通过 <router-link to="/user/123">访问(正常)

解决方案:

// vue.config.js
module.exports = {
  devServer: {
    historyApiFallback: true
  },
  // 生产环境构建路径
  publicPath: process.env.NODE_ENV === 'production' ? '/' : '/'
}

总结

  • router-link 能访问:因为这是前端路由跳转,不请求服务器
  • 直接输入URL不能访问:浏览器向服务器请求该路径,服务器没有对应资源
  • 解决方案:配置服务器将所有路由指向 index.html,让 Vue Router 处理路由

你用的是哪种服务器环境?我可以提供更具体的配置方案。

到此这篇关于vue项目页面刷新后报404的解决方法的文章就介绍到这了,更多相关vue页面刷新404内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 从vue源码看props的用法

    从vue源码看props的用法

    平时写vue的时候知道 props 有很多种用法,今天我们来看看vue内部是怎么处理 props 中那么多的用法的。非常具有实用价值,需要的朋友可以参考下
    2019-01-01
  • axios全局注册,设置token,以及全局设置url请求网段的方法

    axios全局注册,设置token,以及全局设置url请求网段的方法

    今天小编就为大家分享一篇axios全局注册,设置token,以及全局设置url请求网段的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-09-09
  • vue如何通过props方式在子组件中获取相应的对象

    vue如何通过props方式在子组件中获取相应的对象

    这篇文章主要介绍了vue如何通过props方式在子组件中获取相应的对象,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • vant中的Cascader级联选择异步加载地区数据方式

    vant中的Cascader级联选择异步加载地区数据方式

    这篇文章主要介绍了vant中的Cascader级联选择异步加载地区数据方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-07-07
  • vue中组件间多种传值方式案例详解

    vue中组件间多种传值方式案例详解

    vue中每个组件都是隔离的,包括父组件和子组件,各组件之间需要数据通信,就涉及到了组件传值,本文给大家介绍vue中组件间多种传值方式案例,感兴趣的朋友跟随小编一起看看吧
    2024-03-03
  • Vue中使用 ElementUi 的 el-select 实现全选功能(思路详解)

    Vue中使用 ElementUi 的 el-select 实现全选功能(思路详解

    在开发中,有一个需求是 选项组件中使用到一个 全选的功能,特在这记录下实现的方法,方便后续的查阅,以及方便大家查阅借鉴,对vue   ElementUi 全选功能感兴趣的朋友一起看看吧
    2024-02-02
  • 关于Vue实例创建的整体流程

    关于Vue实例创建的整体流程

    这篇文章主要介绍了关于Vue实例创建的整体流程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • 关于axios配置请求头content-type实例详解

    关于axios配置请求头content-type实例详解

    现在前端开发中需要通过Ajax发送请求获取后端数据是很普遍的一件事情了,下面这篇文章主要介绍了关于axios配置请求头content-type的相关资料,需要的朋友可以参考下
    2022-04-04
  • 使用vue3重构拼图游戏的实现示例

    使用vue3重构拼图游戏的实现示例

    这篇文章主要介绍了使用vue3重构拼图游戏的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • vue App.vue中的公共组件改变值触发其他组件或.vue页面监听

    vue App.vue中的公共组件改变值触发其他组件或.vue页面监听

    这篇文章主要介绍了vue App.vue里的公共组件改变值触发其他组件或.vue页面监听,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-05-05

最新评论