maven工程打包老是报错_SpringBoot+Vue组合打包，首页路径竟然找不到

谁借莪１个温暖的怀抱￠ 2023-01-02 08:29 177阅读 0赞

# **背景** #

Vue 作为数据驱动的前端框架，目前比较流行，因此我们公司最新的项目开发都选择 “SpringBoot 后台 + Vue 前端” 这个技术组合。如果一开始就选择这个技术组合，完全没问题。

但是，如果前端技术最初是传统的 html ，加上 Vue 后，旧的 web.xml 配置的欢迎页面为 ../index.html ，导致访问首页报错，本文来分析下这个问题。

# **SpringBoot + 传统 webapp** #

一个基于 SpringBoot 的 web 应用，工程最初选择的前端技术是 html 和 jsp 所以有 webapp 目录，且指定了 web.xml 文件：

![10c676fd7e4e885a3c65b0ccaf5f2093.png][]

webapps 目录下有默认首页 index.html

![feb6b0c58c2c34ef41e47b0f5b91e8f0.png][]

# **SpringBoot+ Vue 新组合** #

前端使用 Vue ，配置 vue.config.js 中 build 目录为

module.exports = {  outputDir: './src/main/resources/static',  publicPath: './',  devServer: {    port: 8080, // 端口  },};

maven 打包时，执行前端打包命令，完成前后台内容统一打包：

org.codehaus.mojo        exec-maven-plugin        exec-npm-installprepare-packageexecnpm                              install                            ./exec-npm-run-buildprepare-packageexecnpm                              run                build                            ./

# **新旧叠加产生的打包问题** #

使用了 webapp 目录，同时又有 vue 时，打包生成的 xxx.war 包部署到 Tomcat 后，直接访问应用，由于 web.xml 中指定了路径 ../index.html，后台报错：

![1a13251f2105243133391425860fcc60.png][]

catalina.out 异常：

22-Nov-2020 07:36:52.993 严重 [http-nio-8080-exec-5] org.apache.coyote.http11.Http11Processor.service 错误的处理请求java.lang.IllegalArgumentException: 资源路径[/../index.html]已规范化为无效的[null]

# **首页静态文件检索路径如何** #

**第一种，static/index.html**

删掉 webapps 目录下的 index.html 和 web.xml 这两个文件后，重启应用，能正常访问到 static 目录下的 index.html 页面：

![0dee2de411200bcaa814c30d3dfa365c.png][]

**第二种**，如果保留 webapp 下的 index.html 和 web.xml 文件后，SpringBoot 默认的 web.xml 配置文件失效。此时，修改自定义的 web.xml 修正路径为 index.html 去掉相对路径后，再次访问，能正常：

![328f7a426ed0222bfd77dcaa64a5b161.png][]

**第三种，** 编辑 web.xml 配置文件路径为 ./index.html 效果和 index.html 一样。这就会走 SpringBoot 默认的静态文件查找逻辑。

# **启示录** #

第一点，自定义的 web.xml 会覆盖掉 SpringBoot 的默认配置。

第二点，web.xml 中指定了相对路径 ./index.html 或 index.html ，相对查找顺序是先 /static ，再是 / ，所以都能成功查到首页。

第三点，web.xml 中只指定一个 welcome-file 文件 ../index.html 文件，访问报错，**但是如果再随便加一行配置，就****能走****默认查找到 static 的文件**。

![3edc9355510c106497820bbc48149b32.png][]

通过各种配置测试，发现没有办法通过自定义的 web.xml 修改 SpringBoot 的应用的首页，这点也挺让笔者捉摸不透的！

[10c676fd7e4e885a3c65b0ccaf5f2093.png]: /images/20221120/bd0d571720a0422dbcff33b9eb71ab1a.png
[feb6b0c58c2c34ef41e47b0f5b91e8f0.png]: /images/20221120/1203001ef9394a7a9af39c3a5153b7e8.png
[1a13251f2105243133391425860fcc60.png]: /images/20221120/08091d86ad6c499c8c470f4b073c41b8.png
[0dee2de411200bcaa814c30d3dfa365c.png]: /images/20221120/41b87512f33a4a379a98c49e556938c8.png
[328f7a426ed0222bfd77dcaa64a5b161.png]: /images/20221120/aa6ceb92f23e4b52b4ce5a4ecbb34a03.png
[3edc9355510c106497820bbc48149b32.png]: /images/20221120/2d4c49ee18d24b7ca8c1adc325763223.png