在Open Liberty部署Spring Cloud Gateway遇WebMvcConfigurer类缺失等问题

核心问题分析 #

Spring Cloud Gateway基于Spring WebFlux（响应式编程模型），和传统的Spring MVC（spring-boot-starter-web/spring-webmvc）完全不兼容。你遇到的类缺失、不兼容提示、Bean冲突等一系列问题，本质是依赖清理不彻底叠加Open Liberty容器类加载逻辑导致的。

分步解决方案 #

1. 彻底清理Spring MVC依赖

   • 打开pom.xml，直接删除spring-boot-starter-web、spring-webmvc这类显式依赖。
   • 执行mvn dependency:tree命令，排查是否有第三方依赖隐式引入了Spring MVC。如果发现，用<exclusions>强制排除，示例：

     <dependency>
         <groupId>org.springframework.cloud</groupId>
         <artifactId>spring-cloud-starter-gateway</artifactId>
         <exclusions>
             <exclusion>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-starter-web</artifactId>
             </exclusion>
         </exclusions>
     </dependency>
     

2. 强制设置响应式Web应用类型

   • 在application.properties（或application.yml）中添加：

     spring.main.web-application-type=reactive
     

     这会让Spring Boot以WebFlux模式启动，完全适配Gateway的运行环境，避免触发MVC相关的初始化逻辑。

3. 配置Open Liberty类加载隔离

   • Open Liberty自带Servlet容器类库，可能和Spring WebFlux的类加载逻辑冲突。修改server.xml中的应用配置，添加类加载器隔离规则：

     <application id="gateway-app" name="gateway-app" location="${project.build.finalName}.war" type="war">
         <classloader delegation="parentLast"/>
     </application>
     

     parentLast让应用优先加载自身依赖，避免容器自带的类覆盖Spring的响应式类。

4. 修正liberty-maven-plugin配置

   • 确保插件正确打包响应式应用，示例配置：

     <plugin>
         <groupId>io.openliberty.tools</groupId>
         <artifactId>liberty-maven-plugin</artifactId>
         <version>3.8.2</version>
         <configuration>
             <serverName>defaultServer</serverName>
             <packageFile>${project.build.directory}/${project.artifactId}.war</packageFile>
             <include>runnable</include>
         </configuration>
     </plugin>
     

5. 禁用Bean覆盖配置

   • 不要开启spring.main.allow-bean-definition-overriding=true，这只会掩盖依赖冲突的根源。如果仍有Bean命名冲突，回到第一步重新排查依赖树，确保没有残留的MVC相关Bean定义。

验证步骤 #

1. 执行mvn clean package确认打包过程无依赖冲突报错
2. 执行mvn liberty:run启动应用，检查日志是否消除WebMvcConfigurer.class缺失及Bean冲突的问题

内容的提问来源于stack exchange，提问作者Sai Kolluri