<th
ink>我们遇到了一个Spr
ingBoot启动失败的问题，关键错误信息是：Causedby
:java
.lang
.Error
:factoryalready
definedatjava
.net
.URL
.setURLStreamH
andlerFactory(UnknownSource)~[na
:1
.8
.0_31]atorg
.apache
.catal
ina
.webresources
.TomcatURLStreamH
andlerFactory
.<
init>(
TomcatURLStreamH
andlerFactory
.java
:130)这个错误表明
Tomcat试图设置URLStreamH
andlerFactory，但是JVM只允许设置一次，而之前已经设置过了。原因分析：在同一个JVM中，java
.net
.URL的setURLStreamH
andlerFactory方法只能被调用一次。如果Spr
ingBoot应用被打包成可执行jar，并且这个jar被其他类加载器加载（例如通过另一个Spr
ingBoot应用加载），或者应用中存在多个
Tomcat实例，则可能导致此问题。解决方案：1
.确保没有多个
Tomcat实例被初始化（比如重复的Spr
ingBoot应用上下文）。2
.避免在同一个JVM中多次启动Spr
ingBoot应用（例如在测试中多次启动）。3
.如果使用了自定义的类加载器，确保不会重复加载
Tomcat相关类。4
.在Spr
ingBoot配置中禁用
Tomcat的URL流处理工厂。具体步骤：方案一：升级Spr
ingBoot版本这个问题在Spr
ingBoot的较新版本中已经修复。尝试升级到Spr
ingBoot2
.4
.x或更高版本。方案二：禁用
Tomcat的URL流处理工厂在application
.properties中添加：```properties
server.tomcat.reg
ister
-url
-protocols=false```方案三：检查是否重复初始化确保在应用中只创建了一个Spr
ingApplication实例。方案四：检查类路径确保类路径中没有重复的
Tomcat嵌入包。方案五：使用自定义的
TomcatServletWeb
ServerFactory通过编程方式禁止
Tomcat注册URL流处理工厂。```javaimportorg
.apache
.catal
ina
.webresources
.TomcatURLStreamH
andlerFactory;importorg
.spr
ingframework
.boot
.web
.em
bedded
.tomcat.TomcatServletWeb
ServerFactory;importorg
.spr
ingframework
.boot
.web
.server.Web
ServerFactoryCustomizer;importorg
.spr
ingframework
.context.an
notation
.Bean;importorg
.spr
ingframework
.context.an
notation
.Configuration;@Configurationpublicclass
TomcatConfig{static{//防止
TomcatURLStreamH
andlerFactory被初始化多次
TomcatURLStreamH
andlerFactory
.d
isable();}@
BeanpublicWeb
ServerFactoryCustomizer<
TomcatServletWeb
ServerFactory>
tomcatCustomizer(){returnfactory
->factory
.add
ContextCustomizers(
context->{//禁用资源注册
context.setResources(null);});}}```方案六：检查打包方式如果是通过jar
injar的方式打包（例如使用Spr
ingBoot
MavenPlug
in），尝试改为war包或者可执行jar的单独运行。方案七：避免在测试中使用@Spr
ingBootTest多次启动如果是在测试中遇到，确保使用@Dirties
Context注解来清理上下文。方案八：检查是否有其他库设置了URLStreamH
andlerFactory查找项目中是否有其他代码调用了URL
.setURLStreamH
andlerFactory。示例代码：使用静态块禁用
TomcatURLStreamH
andlerFactory在Spr
ingBoot主类中添加静态块：```javaimportorg
.apache
.catal
ina
.webresources
.TomcatURLStreamH
andlerFactory;@Spr
ingBootApplicationpublicclassDemoApplication{static{
TomcatURLStreamH
andlerFactory
.d
isable();}publicstaticvoidma
in(Str
ing[]args){Spr
ingApplication
.run(DemoApplication
.class,args);}}```方案九：使用JavaAgent（高级）如果以上方法无效，考虑使用JavaAgent在类加载时修改URL类的行为（不推荐，除非必要）。方案十：检查JVM参数确保没有在JVM参数中设置自定义的URLStreamH
andlerFactory。详细解释：
Tomcat在初始化资源时，会尝试注册一个URLStreamH
andlerFactory，用于处理"war"协议的URL。但是，JVM只允许设置一次。因此，如果应用中已经设置过（可能是另一个
Tomcat实例，或者其他库设置过），就会抛出此错误。在Spr
ingBoot中，通常是因为应用被打包成一个可执行jar，然后又被另一个应用作为依赖引入并执行，导致两个
Tomcat实例尝试设置。或者，在同一个应用内，由于类加载器的原因，导致
Tomcat类被加载多次。因此，最直接的解决方案是禁用
Tomcat的资源注册功能，或者确保
TomcatURLStreamH
andlerFactory只被初始化一次。注意：禁用
Tomcat的资源注册可能会影响静态资源的加载，但通常Spr
ingBoot应用使用Spr
ingMVC的ResourceH
andlers，所以影响不大。如果问题依旧，请提供更多关于项目结构和打包方式的信息。§§相关问题§§
:1
.如何在Spr
ingBoot中自定义
Tomcat配置？2
.如何解决Spr
ingBoot应用在测试中多次启动导致的上下文冲突？3
.Spr
ingBoot不同版本中
Tomcat自动配置有哪些变化？4
.如何排查Java中的类加载器冲突问题？</th
ink>## 解决 "factory already
defined" 导致的
Tomcat 启动失败问题
从您提供的错误日志来看，核心问题是 `java
.lang
.Error
: factory already
defined`，这导致 Spr
ing Boot 无法启动嵌入式
Tomcat 服务器。以下是完整的解决方案：
### 问题原因分析
1
. **URLStreamH
andlerFactory 重复注册**：
- Tomcat 尝试注册自己的 `URLStreamH
andlerFactory`
- JVM 只允许注册一个全局 URLStreamH
andlerFactory
- 应用中其他组件（如另一个 Web 框架或库）已注册了工厂
2
. **类加载器冲突**：
- 多个类加载器加载了
Tomcat 相关类
- WAR 包部署和嵌入式
Tomcat 冲突
3
. **依赖冲突**：
- 多个版本的
Tomcat 相关库存在于类路径
- Spr
ing Boot Starter Web 与其他 Web 容器冲突
4
. **打包问题**：
- 使用了非标准的打包方式
- 可执行 JAR 与外部
Tomcat 部署冲突
### 解决方案
#### 1
. 禁用
Tomcat 的 URLStreamH
andlerFactory（推荐）
在 `application
.properties` 中添加：
```properties
# 禁用
Tomcat 的 URL 流处理器工厂
server.tomcat.reg
ister
-url
-protocols=false
```
或在主配置类中添加：
```java
import org
.apache
.catal
ina
.webresources
.TomcatURLStreamH
andlerFactory;
import org
.spr
ingframework
.boot
.web
.em
bedded
.tomcat.TomcatServletWeb
ServerFactory;
import org
.spr
ingframework
.boot
.web
.server.Web
ServerFactoryCustomizer;
import org
.spr
ingframework
.context.an
notation
.Bean;
import org
.spr
ingframework
.context.an
notation
.Configuration;
@Configuration
public class
TomcatConfig {
static {
// 防止
TomcatURLStreamH
andlerFactory 初始化
TomcatURLStreamH
andlerFactory
.d
isable();
}
@
Bean
public Web
ServerFactoryCustomizer<
TomcatServletWeb
ServerFactory>
tomcatCustomizer() {
return factory
-> factory
.add
ContextCustomizers(
context -> {
// 禁用资源注册
context.setResources(null);
});
}
}
```
#### 2
. 排除冲突依赖
在 `pom
.xml` 中排除可能引起冲突的依赖：
```
xml
<dependencies>
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-web</artifactId>
<exclusions>
<!
-- 排除
Tomcat 使用其他容器
-->
<exclusion>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<!
-- 使用 Jetty 替代
Tomcat -->
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-jetty</artifactId>
</dependency>
<!
-- 或者使用 Undertow
-->
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-undertow</artifactId>
</dependency>
</dependencies>
```
#### 3
. 修复类加载器问题
创建自定义类加载器配置：
```java
import org
.spr
ingframework
.boot
.loader
.LaunchedURLClassLoader;
import org
.spr
ingframework
.boot
.loader
.jar
.JarFile;
public class CustomClassLoader extends LaunchedURLClassLoader {
public CustomClassLoader(JarFile jarFile) throws Exception {
super(jarFile);
}
@Override
protected Class<?> loadClass(Str
ing name, boolean resolve) throws Class
NotFoundException {
// 优先加载应用类
if (name
.startsWith("com
.kucun")) {
return f
indClass(name);
}
// 避免重复加载
Tomcat 类
if (name
.startsWith("org
.apache
.catal
ina")) {
return getParent()
.loadClass(name);
}
return super
.loadClass(name, resolve);
}
}
```
在 `MANIFEST
.MF` 中指定：
```
Ma
in-Class
: org
.spr
ingframework
.boot
.loader
.JarLauncher
Class
-Path
: .
Class
-Loader
: com
.kucun
.CustomClassLoader
```
#### 4
. 升级 Spr
ing Boot 版本
在 `pom
.xml` 中升级到较新版本：
```
xml
<parent>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-parent</artifactId>
<version>2
.7
.0</version> <!
-- 或更高版本
-->
</parent>
<dependencies>
<!
-- 确保所有 starter 版本一致
-->
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-web</artifactId>
</dependency>
</dependencies>
```
#### 5
. 检查并修复打包问题
确保使用正确的打包插件：
```
xml
<build>
<plug
ins>
<plug
in>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-maven-plug
in</artifactId>
<configuration>
<ma
inClass>com
.kucun
.DemoApplication</ma
inClass>
<executable>true</executable>
<!
-- 使用分层 JAR 优化
-->
<layers>
<enabled>true</enabled>
</layers>
</configuration>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plug
in>
</plug
ins>
</build>
```
#### 6
. 检查运行时环境
创建环境检查类：
```java
import org
.spr
ingframework
.boot
.ApplicationArguments;
import org
.spr
ingframework
.boot
.ApplicationRunner;
import org
.spr
ingframework
.stereotype
.Component;
@Component
public class EnvChecker implements ApplicationRunner {
@Override
public void run(ApplicationArguments args) throws Exception {
System
.out
.pr
intln("===== Environment Check =====");
System
.out
.pr
intln("ClassLoader
: " + th
is.getClass()
.getClassLoader());
System
.out
.pr
intln("java
.version
: " + System
.getProperty("java
.version"));
try {
Class<?> factoryClass = Class
.forName("java
.net
.URLStreamH
andlerFactory");
System
.out
.pr
intln("URLStreamH
andlerFactory class loaded by
: " +
factoryClass
.getClassLoader());
} catch (Class
NotFoundException e) {
System
.out
.pr
intln("URLStreamH
andlerFactory
not found");
}
System
.out
.pr
intln("=============================");
}
}
```
### 替代解决方案
如果上述方法无效，考虑以下替代方案：
1
. **使用外部
Tomcat 部署**：
```bash
# 打包为 WAR
mvn clean package
-DskipTests
# 部署到外部
Tomcat
cp target/kucun2
.war $CATAL
INA_HOME/webapps/
```
2
. **切换至 Spr
ing Boot 3 和
Tomcat 10**：
```
xml
<parent>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-starter
-parent</artifactId>
<version>3
.0
.0</version>
</parent>
```
3
. **使用 GraalVM 原生编译**：
```
xml
<build>
<plug
ins>
<plug
in>
<groupId>org
.graalvm
.buildtools</groupId>
<artifactId>native
-maven-plug
in</artifactId>
<version>0
.9
.10</version>
<executions>
<execution>
<goals>
<goal>compile</goal>
</goals>
</execution>
</executions>
</plug
in>
</plug
ins>
</build>
```
```bash
mvn clean package
-Pnative
```
### 预防措施
1
. **统一依赖管理**：
```
xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org
.spr
ingframework
.boot</groupId>
<artifactId>spr
ing
-boot
-dependencies</artifactId>
<version>2
.7
.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
```
2
. **定期清理依赖**：
```bash
mvn dependency
:tree
-Dverbose
-D
includes=org
.apache
.tomcat
mvn dependency
:purge
-local
-repository
```
3
. **使用 Docker 容器化**：
```dockerfile
FROM eclipse
-temur
in:17
-jre
VOLUME /tmp
COPY target/*
.jar app
.jar
ENTRYPO
INT ["java","
-Djava
.security
.egd=file
:/dev/
./ur
andom","
-jar","/app
.jar"]
```
本文介绍了在使用Tomcat部署项目时遇到的特定错误及其解决方法。主要错误信息为Context/lcp-cart-web is defined in server.xml and may not be undeployed。文章提供了两步解决方案：首先删除服务器上的项目及Catalina工作目录下的相关内容，然后重启Tomcat服务。
扫一扫
7865
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
