Java 中 Spring Boot 怎么在非轻量级部署中利用打包排他机制将内置 Tomcat 剥离以发布到外部商用 WebLogic 容器

舞夢輝影

舞夢輝影

2026-07-27

280人浏览

原创

spring boot应用部署到weblogic需改为war包、排除内嵌tomcat、添加jakarta.servlet-api依赖、继承springbootservletinitializer并重写configure方法、配置weblogic.xml优先加载spring包,且移除server相关配置。

java 中 spring boot 怎么在非轻量级部署中利用打包排他机制将内置 tomcat 剥离以发布到外部商用 weblogic 容器

Spring Boot 默认内置 Tomcat,但 WebLogic 是 Java EE 兼容的商用全功能应用服务器,不接受嵌入式容器。要将 Spring Boot 应用部署到 WebLogic,核心不是“打包排他机制”,而是**移除 Servlet 容器依赖 + 适配 Java EE 部署规范 + 确保 WAR 可被 WebLogic 识别和加载**。WebLogic 不运行 `main()` 方法,也不支持 `spring-boot-starter-tomcat`,必须走标准 WAR 部署路径。

修改打包类型为 WAR 并声明为 Web 模块

WebLogic 只部署符合 Java EE 规范的 WAR(或 EAR),不能直接运行 JAR。需强制项目以 WAR 形式构建,并声明其为 Web 应用:

  • pom.xml 根节点下设置:<packaging>war</packaging>
  • 确保父 POM 版本 ≥ 2.3.0(推荐 2.7.x 或 3.x,WebLogic 14c+ 对 Spring Boot 3.x 有官方支持)
  • 不要使用 spring-boot-maven-pluginrepackage 目标——它会把依赖打进 BOOT-INF,WebLogic 无法识别;应禁用或跳过该插件

彻底排除嵌入式 Tomcat 及相关 Servlet 实现

WebLogic 自带完整 Servlet/JSP 容器(基于 Eclipse Jetty 或自研实现),Spring Boot 的嵌入式 Tomcat 不仅冗余,还会引发类冲突(如 javax.servlet.*org.apache.catalina.*):

Java JDK 25
Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。

下载
  • spring-boot-starter-web 中排除 spring-boot-starter-tomcat
<dependency><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-web</artifactid><exclusions><exclusion><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-tomcat</artifactid></exclusion></exclusions></dependency>
  • 显式添加 javax.servlet-api(非实现,仅 API),且 scope 必须为 provided
<dependency><groupid>javax.servlet</groupid><artifactid>servlet-api</artifactid><version>4.0.1</version><scope>provided</scope></dependency>

注意:Spring Boot 2.5+ 推荐用 jakarta.servlet-api(对应 Jakarta EE 9+),若 WebLogic 版本 ≥ 14c(2020 年后),请改用:

<dependency><groupid>jakarta.servlet</groupid><artifactid>jakarta.servlet-api</artifactid><scope>provided</scope></dependency>

提供标准 WebApplicationInitializer 并禁用内嵌启动逻辑

WebLogic 启动时通过 ServletContext 加载应用,不调用 main()。必须提供兼容的初始化入口:

  • 启动类继承 SpringBootServletInitializer,重写 configure()
@SpringBootApplication
public class MyWebLogicApp extends SpringBootServletInitializer {
  @Override
  protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
    return builder.sources(MyWebLogicApp.class);
  }

  // main 方法可保留,但 WebLogic 不会执行它
  public static void main(String[] args) {
    SpringApplication.run(MyWebLogicApp.class, args);
  }
}
  • 确保 src/main/webapp/WEB-INF/web.xml 存在(即使为空),这是 WebLogic 识别传统 WAR 的关键信号;Spring Boot 2.3+ 可省略,但 WebLogic 12c 及更早版本强烈建议保留空文件
  • application.properties 中移除所有与 server 相关配置:server.portserver.servlet.context-pathserver.tomcat.* 等全部失效,由 WebLogic 控制

适配 WebLogic 特定行为与验证部署

WebLogic 对 Spring Boot 的上下文加载、类加载器策略、JNDI 和事务管理有特殊要求:

  • src/main/webapp/WEB-INF/weblogic.xml 中声明类加载优先级(避免 Spring 冲突):
<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app"><container-descriptor><pre class="brush:php;toolbar:false;" fer-application-packages>
      <package-name>org.springframework.*</package-name><package-name>com.fasterxml.jackson.*</package-name>
  • 打包后检查 WAR 结构:根目录下应有 WEB-INF/classes/WEB-INF/lib/,无 BOOT-INF/
  • 部署时选择“安装为应用程序”而非“库”,并启用“自动部署”或手动部署至 autodeploy 目录
  • 访问路径为 http://host:port/<context-root>/<your-endpoint></your-endpoint></context-root>,context-root 来自 WAR 包名或 WebLogic 控制台设置

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

3861

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

2838

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

2854

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

637

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

602

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

705

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1315

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

18844

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

647

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Spring中文手册
Spring中文手册

共0课时 | 0.6万人学习

马士兵spring视频教程
马士兵spring视频教程

共25课时 | 9.7万人学习