Springboot使用war启动的配置

1、前言

Springboot 默认的打包方式是jar 的方式。启动方式也比较简单java -jar xxx.jar。但是很多时候,我们会针对老项目的改造,老项目都是使用传统的war 借助tomcat 启动。可能原来的tomcat 中配置茫茫复杂的东西,如分布式session、调优参数等。下来一起看看Springboot 是如何打成war 的。

2、官方文档解释

本文以springboot 1.5.10.RELEASE为例。

官网地址:https://docs.spring.io/spring-boot/docs/1.5.10.RELEASE/reference/html/howto-traditional-deployment.html#howto-create-a-deployable-war-file

文章中介绍了如何创建一个发布的war 包文件。

第一步:需要继承SpringBootServletInitializer

第二步:重写configure 方法,参数为当前启动类的Class即可

第三步:修改pom文件<packaging>war</packaging>

第四步:将内置的tomcat的生命周期标记为编译期可用,<scope>provided</scope>

到这里Springboot 的war 包形式就打好了,可以愉快的部署发布了。

以上的打包方式都是基于官方文档中Servlet 3.0 的方式打包的,同时官方还对更低版本的Servlet 2.5 做了说明,有兴趣的可以去看看。

3、遇到的问题以及解决

Springboot 1.5.10.RELEASE 这个版本默认的内置tomcat的版本是8.5.27

由于老项目都是部署在tomcat7 的,所以打成war 后想部署在tomcat7上。就会出现版本不兼容的问题。

直接使用外部的tomcat7启动,非常丝滑可以正常启动,但是有瑕疵。

启动成功后可以正常访问,但是启动日志会报错,就是Tomcat7 不能解析部分jar 中的字节码。

日志中就表示解析不了byte-buddy-agent-1.14.11 ,只需要降低byte-buddy-agent 版本即可。

笔者遇到的包括:fastjson2,guava高版本均会编译报错。降低版本后问题解决。

直接使用tomcat8部署也是没有问题,会避免这些问题。

4、使用War启动的原理

Servlet容器 启动使用了SPI的机制。会加载org.springframework.web.SpringServletContainerInitializer

SpringServletContainerInitializer 上面标注了注解@HandlesTypes ,再启动的时候自行加载实现org.springframework.web.WebApplicationInitializer 这个接口的类。将实现类字节码集合的方式传入onStartup方法,然后再分别调用各自的onStartup 方法。

WebApplicationInitializer 中有唯一的方式方法onStartup 方法。可以用来配置servlet、filters、上下文参数等

SpringBootServletInitializer 实现了 WebApplicationInitializer ,自然也会执行相应的onStartup 方法。

创建web容器。主要代码块

  • builder.main(getClass()) ,传入Main 方法。

  • builder = configure(builder) Springboot 使用war 启动要重新的方法,传入当前类的字节码

  • configure 方法是用来给父子容器使用的。再启动过程中会发现,不重写该方法依然可以正常启动并访问。

具体创建Web容器的源码:

5、番外

在使用springboot 1.5.10.RELEASE jar 启动之后遇到的问题:

  • 搭配SpringCloud微服务时,第一次访问会比较慢,后面就正常了

  • 使用Springboot 启动时,客户端调用时,部分接口会出现不定时的超时。

目前不知道具体的原因。解决方案也是从jar 改成war 启动后,这些问题就解决了。有知道大佬,可以留言交流。

流。

相关推荐
yuniko-n4 分钟前
【JUC】集合线程安全
java
starzy19901 小时前
Flink SlotManager启动流程源码深度剖析:从ResourceManager到Slot分配的完整链路
java·大数据·flink
极光通讯1 小时前
服务器内存来料检验(IQC)实操:批次追溯、外观判定与上机验证
java·服务器·算法
4SAPI1 小时前
AI API Gateway平台哪个好?从架构视角看企业多模型网关选型与实践
java·大数据·人工智能·gateway·php
EatFan1 小时前
2026 后端 AI 工程化:Spring AI 2.0、MCP 协议与 Agent 内嵌如何收进 Java 生产系统
java·人工智能·spring·agent·spring ai·spring boot 3·mcp
JPower_mr.g1 小时前
SmartCall 音色管理技术解析:基于 SPI 的可扩展音色注册架构
java·开发语言·人工智能·ai·架构·开源
测试开发Kevin1 小时前
IDEA工程结构解析:项目、模块、库、Facet、Artifact (工件) 概念说明
java·ide·intellij idea
大侠归来1 小时前
Spring Boot 2.1 → 3.5 迁移推演:从实战出发的完整路线图
java·spring boot·后端
Wang's Blog1 小时前
Java 中间件之 RabbitMQ 快速入门: SpringAMQP 的 DirectExchange 路由模式
java·中间件·java-rabbitmq
Sweet锦2 小时前
jDCS 开源项目:面向工业现场的 Modbus RTU 数据采集基础框架
java·spring boot·物联网·开源