<think>我们遇到了一个
WebLogic
部署异常，错误信息指出存在多个同名的
Web片段（
Web fragment）"
spring_
web"。
在
Java Web应用中，
Web片段是
web.xml的一部分，它允许将配置分散到各个库或框架的JAR文件中。每个库可以包含一个位于META-INF/
web-
fragment.xml的文件，该文件可以定义Servlet、过滤器等，而不需要修改主
web.xml。
错误信息表明，在
部署的应用程序中，有多个JAR文件包含了名为"
spring_
web"的
Web片段。
WebLogic要求每个
Web片段的名称必须是唯一的。
解决方案：
1
. 检查
项目中包含的JAR文件，特别是与
Spring相关的JAR，看是否有多个JAR文件包含
web-
fragment.xml文件，并且它们都声明了相同的<
name>
spring_
web</
name>。
2
. 通常，这个问题可能是由于引入了不同版本的
Spring框架JAR包，或者多个JAR包都包含了相同的
web-
fragment.xml配置。
解决步骤：
a) 定位到
项目中所有包含
web-
fragment.xml的JAR文件，并检查这些文件中<
name>元素的内容。
例如，使用压缩工具打开JAR文件，查看META-INF/
web-
fragment.xml，找到<
name>标签。
b) 如果发现多个JAR文件中的
web-
fragment.xml都使用了相同的名称（如"
spring_
web"），则需要通过排除重复的JAR包或者修改其中一个
web-
fragment.xml的<
name>来解决。
但是，修改第三方库的JAR文件并不推荐，因为这会带来维护问题。更常见的做法是排除重复的依赖。
另一种方法是在
weblogic
.xml中设置<container-descript
or>元素来忽略重复的
web-
fragment.xml。具体如下：
在
项目的
WEB-INF/
weblogic
.xml文件中添加以下配置：
```xml
<container-descript
or>
<prefer-
web-inf-classes>true</prefer-
web-inf-classes>
<prefer-application-packages>
<package-
name>
org
.springframew
ork
.*</package-
name>
</prefer-application-packages>
<show-archived-real-path-enabled>true</show-archived-real-path-enabled>
<!-- 添加以下配置以忽略重复的
Web片段 -->
<ign
ore-
web-
fragments>true</ign
ore-
web-
fragments>
</container-descript
or>
```
但是，请注意，`<ign
ore-
web-
fragments>`标签在
WebLogic 12
.1
.3及更高版本中可用。这个设置会告诉
WebLogic忽略所有
web-
fragment.xml文件，只使用主
web.xml。这可能会影响应用程序的功能，因为一些框架（如
Spring）需要
web-
fragment.xml来注册Servlet和过滤器。
因此，更精确的解决方案是排除重复的JAR。
如何排除重复的JAR？
使用Maven或Gradle构建工具，检查依赖树，排除重复的
Spring Web相关JAR。
例如，在Maven中，可以使用以下命令检查依赖树：
```
mvn dependency
:tree
```
然后，如果发现有两个不同的依赖都引入了包含相同
web-
fragment.xml的JAR，可以在其中一个依赖中排除掉。
例如，假设依赖树显示：
```
[INFO] +-
org
.springframew
ork
:spring-
webmvc
:jar
:4
.3
.18
.RELEASE
:compile
[INFO] | \-
org
.springframew
ork
:spring-
web:jar
:4
.3
.18
.RELEASE
:compile
[INFO] \-
org
.springframew
ork
:spring-
web:jar
:5
.0
.8
.RELEASE
:compile
```
这里有两个不同版本的
spring-
web。我们需要排除掉一个。
在pom
.xml中，可以这样排除：
```xml
<dependency>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
webmvc</artifactId>
<version>4
.3
.18
.RELEASE</version>
<exclusions>
<exclusion>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
web</artifactId>
</exclusion>
</exclusions>
</dependency>
```
这样，我们排除了旧版本的
spring-
web，然后显式引入新版本的
spring-
web：
```xml
<dependency>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
web</artifactId>
<version>5
.0
.8
.RELEASE</version>
</dependency>
```
如果问题不是由于多个版本的
spring-
web，而是其他库也包含了名为"
spring_
web"的
web-
fragment.xml，那么我们需要找到这些库并排除。
另外，如果无法排除，也可以考虑修改其中一个JAR中的
web-
fragment.xml，但这需要重新打包该JAR，并确保在
项目中引用修改后的版本。
由于修改第三方库不推荐，因此我们优先考虑排除依赖或使用
weblogic
.xml配置忽略重复片段。
但是，如果使用`<ign
ore-
web-
fragments>true</ign
ore-
web-
fragments>`，那么所有
web-
fragment.xml都会被忽略，这可能会影响应用功能（比如
Spring Security的配置可能就失效了）。因此，我们需要评估是否可行。
另一种
WebLogic的配置是使用`<
weblogic-
web-app>`的`<container-descript
or>`子元素来指定特定的重复片段被忽略，但
WebLogic并没有提供按名称忽略的配置。
因此，最安全的方式还是解决依赖冲突。
如果上述方法都不可行，还可以尝试在
web.xml中通过`<absolute-
ordering>`元素指定使用哪些
Web片段。例如，在
web.xml中：
```xml
<
web-app
... version="3
.0">
...
<absolute-
ordering>
<!-- 只允许名为
spring_
web的片段，并且只出现一次 -->
<
name>
spring_
web</
name>
<!-- 也可以指定其他需要使用的片段，或者使用<o
thers />来包含其他片段 -->
</absolute-
ordering>
</
web-app>
```
但是，如果多个片段都叫同一个名字，那么这里指定`<
name>
spring_
web</
name>`还是会
报错，因为无法区分。
因此，我们回到根本：必须确保没有两个
web-
fragment.xml使用相同的名称。
总结步骤：
1
. 找出所有包含
web-
fragment.xml且其中<
name>为"
spring_
web"的JAR包。
2
. 通过构建工具排除重复的JAR包，确保只有一个JAR包包含名为"
spring_
web"的
web片段。
如果无法排除（比如两个不同的库都必须使用，且它们都包含同名的
web片段），那么可能需要联系库的维护者，或者考虑是否其中一个库可以被替换。
代码示例：由于这是一个配置和依赖管理问题，没有具体的代码，但我们可以给出一个
weblogic
.xml配置的示例，用于忽略所有
web片段（作为临时解决方案，但需谨慎）。
下面是一个
weblogic
.xml配置示例，用于忽略所有
web片段：
```xml
<?xml version="1
.0" encoding="UTF-8"?>
<
weblogic-
web-app xmlns="http
://xmlns
.oracle
.com/
weblogic/
weblogic-
web-app">
<container-descript
or>
<ign
ore-
web-
fragments>true</ign
ore-
web-
fragments>
</container-descript
or>
</
weblogic-
web-app>
```
注意：这个配置可能会导致依赖于
web片件的框架（如
Spring MVC）无法自动注册DispatcherServlet等，因此需要在主
web.xml中手动注册这些Servlet和过滤器。
因此，如果使用此配置，请确保在
web.xml中已经配置了所有必要的Servlet和过滤器。
例如，对于
Spring MVC，通常需要在
web.xml中配置DispatcherServlet：
```xml
<
web-app>
<servlet>
<servlet-
name>dispatcher</servlet-
name>
<servlet-class>
org
.springframew
ork
.web.servlet
.DispatcherServlet</servlet-class>
<init-param>
<param-
name>contextConfigLocation</param-
name>
<param-value>/
WEB-INF/
spring-servlet
.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-
name>dispatcher</servlet-
name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</
web-app>
```
这样，即使忽略了
web片段，我们也能保证
Spring MVC的核心Servlet被注册。
但是，这种方法需要手动配置，可能会比较繁琐，因为一些原本由
web片段自动配置的内容现在需要手动添加。
因此，最佳实践还是解决依赖冲突。
由于没有提供具体的
项目依赖，这里无法给出更具体的排除依赖的代码。但以上步骤应该能帮助解决该问题。
最后，如果问题依旧，请检查
WebLogic的版本，并考虑升级或打补丁，因为一些旧版本的
WebLogic可能存在已知的问题。
现在，根据要求，在最后提出相关问题。
§§相关问题§§
:
1
. 在Maven中如何查看并解决依赖冲突？
2
. 如何配置
WebLogic的
weblogic
.xml文件来处理Servlet 3
.0的注解和
Web片段？
3
. 在
Spring框架中，
web-
fragment.xml通常用于哪些配置？
4
. 除了
WebLogic，还有哪些应用服务器会遇到
Web片段重复的问题？如何解决？</think>### 解决
WebLogic
部署中的 "
There is
more than one Web fragment with the same
name: spring_
web" 错误
这个错误发生在
WebLogic 检测到多个 JAR 文件包含同名的 `
web-
fragment.xml` 文件（都声明了 `<
name>
spring_
web</
name>`）。常见于
Spring 相关依赖冲突。
#### 解决方案 1：排除重复依赖（推荐）
在 Maven/Gradle 中排除重复的 `
spring-
web` 或 `
spring-
webmvc` 依赖：
```xml
<!-- Maven 示例 -->
<dependency>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
webmvc</artifactId>
<version>5
.3
.18</version>
<exclusions>
<!-- 排除冲突的
spring-
web -->
<exclusion>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
web</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 显式声明统一版本 -->
<dependency>
<groupId>
org
.springframew
ork</groupId>
<artifactId>
spring-
web</artifactId>
<version>5
.3
.18</version>
</dependency>
```
#### 解决方案 2：配置 `
weblogic
.xml`
在 `
WEB-INF/
weblogic
.xml` 中添加配置忽略重复片段：
```xml
<
weblogic-
web-app xmlns="http
://xmlns
.oracle
.com/
weblogic/
weblogic-
web-app">
<container-descript
or>
<!-- 方法1：完全忽略所有
web-
fragment -->
<ign
ore-
web-
fragments>true</ign
ore-
web-
fragments>
<!-- 方法2：精确指定加载顺序 (Servlet 3
.0+) -->
<prefer-application-resources>
<resource-
name>META-INF/
web-
fragment.xml</resource-
name>
</prefer-application-resources>
</container-descript
or>
</
weblogic-
web-app>
```
#### 解决方案 3：检查并清理重复 JAR
1
. 检查
项目包含的 JAR：
```bash
# 查找包含
web-
fragment.xml 的 JAR
find
. -
name "*
.jar" -exec grep -l "META-INF/
web-
fragment.xml" {} \;
# 检查冲突文件内容
unzip -p
spring-
web-5
.3
.18
.jar META-INF/
web-
fragment.xml | grep "<
name>"
```
2
. 常见冲突来源：
- 不同版本的 `
spring-
web.jar` 和 `
spring-
webmvc
.jar`
- 第三方库内嵌的
Spring 版本
- 旧版 `
spring-
web-services
.jar`
#### 解决方案 4：在 `
web.xml` 中声明绝对顺序
```xml
<
web-app
... version="3
.1">
<absolute-
ordering>
<!-- 只允许指定的
fragment -->
<
name>
spring_
web</
name>
<!-- 其他需要保留的
fragment -->
<
name>o
ther_
fragment</
name>
<!-- 完全禁用其他
fragment -->
<!-- <o
thers/> -->
</absolute-
ordering>
</
web-app>
```
### 问题根本原因
Spring 的 `
web-
fragment.xml` 在以下 JAR 中定义：
```
spring-
web-*
.jar → META-INF/
web-
fragment.xml
```
当多个版本或不同变体的
Spring Web JAR 同时存在时，
WebLogic 会因名称冲突拒绝
部署。
### 最佳实践
1
. 使用 Maven 依赖树检查冲突：
```bash
mvn dependency
:tree -Dincludes=
org
.springframew
ork
:spring-
web
```
2
. 确保所有
Spring 组件版本一致
3
. 优先使用 `
spring-boot-starter-
web` 管理依赖
超级会员免费看
在TOMCAT部署项目时遇到报错：More than one fragment with the name [spring_web] was found。经过调查，问题出在webapps项目名WEB-INFlib目录下存在两个不同版本的spring-web.jar。删除冗余的jar包，保留一个版本后，错误成功解决。
扫一扫
4705
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
