怎么解决多个独立 War 包在同一 Tomcat 容器下因共享类加载器引发的配置污染

阿磊小哥_3604

阿磊小哥_3604

2026-06-02

673人浏览

原创

tomcat类加载隔离核心是“精准隔离”:javax.servlet等容器契约类必须由父加载器统一供给以防linkageerror,业务配置类和多版本工具包须由webappclassloader优先加载,shared.loader可显式控制通用工具库共享。

核心思路是:不靠“禁用共享”,而靠“精准隔离”——让每个 war 自己管自己的配置类,同时确保容器契约类(如 javax.servlet.*)仍由 tomcat 统一提供,避免 linkageerror。

明确哪些类必须共享、哪些必须隔离

Tomcat 的类加载器分层不是摆设,而是有明确职责划分:

  • 必须由父加载器统一供给的:所有 javax.servlet.*、org.apache.catalina.*、jakarta.*(Tomcat 10+)等容器规范类。这些若被各应用重复打包,会直接触发 LinkageError 或 ClassCastException
  • 必须由 WebAppClassLoader 优先加载的:业务配置类(如 application.yml 对应的 YamlPropertySourceLoader)、Spring Boot 的自动配置类、自定义的 @Configuration 类、以及不同版本的工具包(如 commons-lang3-3.12.jar vs commons-lang3-3.9.jar)
  • 可选共享但需显式控制的:通用工具库(如 fastjson、slf4j-api)。这类建议放入 $CATALINA_BASE/lib/shared/,并在 catalina.properties 中启用 shared.loader

从构建阶段切断污染源头

很多“配置污染”其实在打包时就已埋下。关键动作如下:

秒绘AI
秒绘AI

一款AI图像与设计工具,主要用于秒绘AI,让电商上新快人一步,适合需要提升相关任务效率的用户。

下载
  • Maven 中将容器 API 标记为 provided:
    <dependency><groupid>jakarta.servlet</groupid><artifactid>jakarta.servlet-api</artifactid><scope>provided</scope></dependency>
  • 检查 WAR 包内容,确认没有重复打包 servlet-api.jar、tomcat-*.jar 等容器内部类 —— 使用 jar -tf your-app.war | grep -i "servlet\|catalina" 快速验证
  • Spring Boot 项目打 WAR 时,确保排除内嵌 Tomcat:
    <exclusions><exclusion><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-tomcat</artifactid></exclusion></exclusions>

运行时通过类加载策略加固隔离

在 $CATALINA_BASE/conf/catalina.properties 中调整关键参数:

  • 设置 loader.delegate=false(默认为 false,但务必确认)—— 这是 WebAppClassLoader “先查自己再委托”的前提
  • 若需共享基础工具类,启用并配置 shared.loader:
    shared.loader=${catalina.base}/lib/shared/*.jar,然后把 slf4j-api.jar、logback-classic.jar 等放进去
  • 禁止应用覆盖核心包:确保 common.loader 中未意外包含应用级 jar;检查 $CATALINA_HOME/lib 下无 spring-core.jar、mybatis.jar 等业务依赖

识别和定位典型污染现象

以下日志特征往往指向类加载污染:

  • FactoryConfigurationError: Provider org.apache.xerces.jaxp.SAXParserFactoryImpl not found → 应用打包了旧版 Xerces,但 JDK 14+ 已移除内置支持,又没正确委托给容器或 JVM
  • java.lang.LinkageError: loader constraint violation → 同一个类(如 HttpServlet)被两个不同加载器加载
  • NoClassDefFoundError 出现在某个 WAR 启动成功后、另一个启动失败时 → 前者抢先加载了某类,后者因委托机制找不到兼容版本
  • 配置类生效异常(如 @Value("${my.prop}") 取到空值或旧值)→ 多个 application.properties 被不同加载器混读,或 PropertySourcesPlaceholderConfigurer 实例被共享

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2889

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2208

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1160

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1118

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1316

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2038

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3200

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

14175

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

529

3

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Tomcat核心原理解析
Tomcat核心原理解析

共57课时 | 8.8万人学习