Tomcat：部署前后端分离项目踩坑

是席木木啊2025-05-24 8:22

很久没有使用Tomcat部署前后端分离项目了，这两天遇到小伙伴有这方面的需求，就做了尝试，踩坑记录如下。

坑点1：SpringBoot打包本地jar包依赖未被包含

SpringBoot如果在开发阶段应用了本地jar包，在打成jar包时，通常是需要在pom.xml文件中添加如下配置，可以确保在打包阶段本地jar包被正常引入和构建。

但是，将SpringBoot打包成war包时，以上配置就会失效了。将其放入tomcat中启动时，会报错：找不到本地依赖的jar包。其实，该jar包已经被构建过了，只是没有被放到正确的路径下。

在tocmat的webapps中，查看服务路径WEB_INFO下，有两个子路径：lib和lib-provided，而提示找不到的jar包就是被放到了lib-provided子路径下，只需要将其拷贝到lib子路径下，即可保证war包部署到tomcat中之后，可以正常启动。

坑点2：Vue3前端项目部署路径问题

前端项目使用history路由模式，页面部署之后，只能通过localhost:8080/xxx进行访问，无法通过localhost:8080/路径名/xxx-router访问。

可以修改vite.config.ts中的base配置项进行解决，

坑点3：Vue3前端项目部署之后，刷新页面404

解决方案：在前端所在目录下新建：WEB-INF/web.xml文件，写入内容，

XML 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.0" metadata-complete="true">
<display-name>Router for Tomcat</display-name>
  <error-page>
  <error-code>404</error-code>
  <location>/index.html</location>
  </error-page>
</web-app>