解决vue、springboot项目打包后刷新出现404的问题

望屿

已于 2022-02-13 13:52:49 修改

阅读量5.7k

点赞数 5

CC 4.0 BY-SA版权

于 2022-02-13 13:52:19 首次发布

本文链接：https://blog.youkuaiyun.com/darabiuz/article/details/122908160

开发过程的bug记录专栏收录该内容

17 篇文章

订阅专栏

本文探讨了如何将Vue单页面应用打包至SpringBoot项目中，解决非首页刷新导致的404错误。通过配置ErrorConfig，实现错误页面重定向到index.html并利用前端路由处理跳转。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 问题背景

把vue项目打包后放入springboot的static文件夹里，首先访问首页，然后在里面进行任何页面跳转都是没有问题的，但是假如在非首页的任何一个页面点击刷新，就会报错

2. 问题原因

主要问题在于：由vue开发的应用，采用的是SPA单页面模式

传统的多页面模式，每一个页面对应一个html文件，当我们刷新页面的时候，会主动向后端请求对应的html文件，拿到html文件后渲染界面，但是SPA单页面模式只有一个index.html入口文件，后续的界面跳转都是通过js控制路由跳转实现的
比如，现在想直接访问localhost:9999/login界面，,像后台发送了html问价请求，然而后台并没有login.html这一个html文件，所以就会返回如下的错误，正确的做法应该是：当我们直接输入localhost:9999/login路径时，先将页面重定向到localhost:9999/index.html，然后通过js控制路由实现跳转

3. 问题的解决

在springboot的项目下新建一个error的package，再新建一个ErrorConfig的类，设置出现错误界面时重定向到index.html

package com.example.error;
import org.springframework.boot.web.server.ErrorPageRegistrar;
import org.springframework.boot.web.server.ErrorPage;
import org.springframework.boot.web.server.ErrorPageRegistry;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;

@Component
public class ErrorConfig implements ErrorPageRegistrar {

    @Override
    public void registerErrorPages(ErrorPageRegistry registry) {
        ErrorPage error404Page = new ErrorPage(HttpStatus.NOT_FOUND, "/index.html");
        registry.addErrorPages(error404Page);
    }
}

关于SPA可以看我的下一篇博客