很久没有使用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 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>