Spring Boot中JerseyWebApplicationInitializer自动加载问题解析

问题背景

在Spring Boot 3.4.4版本中，当应用程序引入了spring-boot-autoconfigure依赖时，即使没有使用Jersey框架，JerseyWebApplicationInitializer类也会被自动加载。这个类会设置ServletContext的contextConfigLocation初始化参数为<NONE>，导致与其他WebApplicationInitializer产生冲突，特别是当其他初始化器已经设置了configLocation值时。

问题现象

在Frank!Framework控制台应用中，当引入springdoc（用于Swagger/OpenAPI文档）时，由于springdoc依赖了spring-boot-autoconfigure，触发了这个问题。具体表现为：

1. JerseyWebApplicationInitializer被自动加载
2. 它将ServletContext的contextConfigLocation参数设置为<NONE>
3. 这覆盖了应用中自定义WebApplicationInitializer设置的配置位置
4. 最终导致应用启动失败，抛出FileNotFoundException: Could not open ServletContext resource [/<NONE>]

技术原理分析

这个问题源于Spring Boot自动配置机制与Servlet容器初始化机制的交互方式：

1. JerseyWebApplicationInitializer是JerseyAutoConfiguration的内部静态类
2. 它实现了WebApplicationInitializer接口
3. Servlet容器会自动发现并加载所有WebApplicationInitializer实现类
4. 不同于其他自动配置类，这个初始化器缺少@ConditionalOn*条件注解
5. 它总是会执行，设置ServletContext的初始化参数

解决方案探讨

Spring Boot团队给出了技术上的解释和解决方案方向：

1. 不能使用条件注解的原因：因为WebApplicationInitializer是由Servlet容器直接加载的，而不是通过Spring的条件机制
2. 改进方案：可以修改JerseyWebApplicationInitializer，使其仅在检测到Jersey相关类(org.glassfish.jersey.server.spring.SpringWebApplicationInitializer)存在时才设置初始化参数
3. 临时解决方案：在应用中可以通过编程方式重置ServletContext的contextConfigLocation参数

影响范围

这个问题主要影响以下场景的应用：

1. 使用Spring Boot 3.x版本
2. 引入了spring-boot-autoconfigure但未使用Jersey
3. 应用中自定义了WebApplicationInitializer并依赖contextConfigLocation参数
4. 特别是集成了如springdoc等会引入自动配置的库

最佳实践建议

对于遇到类似问题的开发者，建议：

1. 检查依赖：确认是否真的需要Jersey相关功能
2. 版本升级：关注Spring Boot后续版本是否修复此问题
3. 参数检查：在自定义初始化器中检查并处理contextConfigLocation被覆盖的情况
4. 替代方案：考虑使用Spring MVC而非Jersey（如果功能允许）

这个问题展示了Spring Boot自动配置机制与Servlet容器初始化机制之间的微妙交互，提醒开发者在集成不同技术栈时需要关注这种潜在的配置冲突。