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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 利用vant如何给tabbar配置路由

    利用vant如何给tabbar配置路由

    这篇文章主要介绍了利用vant如何给tabbar配置路由,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • 教你用vue实现一个有趣的围绕圆弧动画效果

    教你用vue实现一个有趣的围绕圆弧动画效果

    最近做的两个项目都是关于vue的,做完整理一下,这篇文章主要给大家介绍了关于如何用vue实现一个有趣的围绕圆弧动画效果的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-04-04
  • vue项目使用modbus实现串口通讯的示例代码

    vue项目使用modbus实现串口通讯的示例代码

    本文主要介绍了vue项目使用modbus实现串口通讯的示例代码,可以实现与Modbus设备的数据交互,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-02-02
  • vue 实现Web端的定位功能 获取经纬度

    vue 实现Web端的定位功能 获取经纬度

    这篇文章主要介绍了vue 实现Web端的定位功能获取经纬度,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-08-08
  • vue-cli3 打包优化之 splitchunks详解

    vue-cli3 打包优化之 splitchunks详解

    这篇文章主要介绍了vue-cli3 打包优化之 splitchunks的相关知识,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-07-07
  • 浅谈vue在html中出现{{}}的原因及解决方式

    浅谈vue在html中出现{{}}的原因及解决方式

    这篇文章主要介绍了浅谈vue在html中出现{{}}的原因及解决方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • vue项目element-ui级联选择器el-cascader回显的问题及解决

    vue项目element-ui级联选择器el-cascader回显的问题及解决

    这篇文章主要介绍了vue项目element-ui级联选择器el-cascader回显的问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • vue中如何实现pdf文件预览的方法

    vue中如何实现pdf文件预览的方法

    这篇文章主要介绍了vue中如何实现pdf文件预览的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-07-07
  • vue2 前端搜索实现示例

    vue2 前端搜索实现示例

    本篇文章主要介绍了vue2 前端搜索实现示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-02-02
  • vue之input输入框防抖debounce函数的使用方式

    vue之input输入框防抖debounce函数的使用方式

    这篇文章主要介绍了vue之input输入框防抖debounce函数的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11

最新评论