切换Spring Boot Webflux至Jetty替代Netty后遇NoClassDefFoundError异常

我来帮你捋清楚这个问题：你把Webflux的服务器从Netty换成Jetty，排除了spring-boot-starter-reactor-netty后启动报错，核心原因是响应式Redis客户端默认依赖Reactor Netty，你可能误把Redis需要的Netty依赖也给排除了，导致出现NoClassDefFoundError。

问题根源拆解 #

Spring Boot Webflux的服务器可以换成Jetty，但如果你的项目用了响应式Redis（比如spring-boot-starter-data-redis-reactive），它底层依赖Reactor Netty作为网络客户端处理异步Redis请求。你只需要替换Webflux的服务器实现（Netty→Jetty），但Redis客户端的Netty依赖不能删，否则就会出现类找不到的错误。

具体解决方案 #

1. 调整Maven依赖配置 #

保留Webflux对Jetty的依赖，只排除Webflux模块里的Netty服务器依赖，不要动Redis相关的Netty依赖：

<!-- Webflux依赖，排除默认的Netty服务器 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-reactor-netty</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 引入Jetty作为Webflux的服务器 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

<!-- 响应式Redis依赖（如果用到的话），不需要排除Netty -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
</dependency>

2. 验证依赖树 #

运行mvn dependency:tree命令，确认：

• spring-boot-starter-reactor-netty只被spring-boot-starter-data-redis-reactive（或其他Redis相关依赖）引用
• Webflux模块不再依赖Netty服务器

3. 完全移除Netty的可选方案（仅特殊需求） #

如果你一定要彻底移除所有Netty依赖，那需要替换Redis的响应式客户端实现，比如改用基于Jetty的Redis客户端，但这种方案需要自定义配置，复杂度较高，不推荐。大多数场景下，让Redis客户端用Netty、Web服务器用Jetty是完全兼容的，不会有冲突。

总结 #

你只需要替换Webflux的服务器为Jetty，Redis客户端的Netty依赖是必要的，不用排除。调整依赖后重新启动应用，BeanCreationException和NoClassDefFoundError应该就能解决了。

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