Spring Cloud Config Server 4.1.0在WebFlux中ResourceController失效咨询

核心结论 #

Spring Cloud Config Server 4.1.0 版本中，ResourceController确实仅支持Servlet栈（Spring Web），尚未提供WebFlux响应式实现，这就是它在WebFlux环境下依赖ServletWebRequest导致无法正常运行的原因。

原因说明 #

虽然Config Server的EnvironmentController已经做了响应式适配，能在WebFlux环境下正常工作，但ResourceController的底层实现仍绑定Servlet API：

• 该控制器的@GetMapping({"/{name}/{profile}/{label}/**"})方法内部依赖ServletWebRequest处理请求，而WebFlux环境基于Reactor Netty，不兼容Servlet相关类，因此会出现运行异常或请求无法处理的情况。
• Spring Cloud Config Server核心设计最初围绕Servlet栈构建，目前仅完成了部分组件的响应式迁移，ResourceController属于未迁移的部分。

可行解决方案 #

• 切换回Servlet栈：如果项目对响应式的需求并非强制，直接改用spring-boot-starter-web替代spring-boot-starter-webflux，所有Config Server控制器都能正常工作。
• 自定义响应式ResourceController：自行实现基于WebFlux的资源控制器，替换原生的ResourceController，通过Config Server核心服务类（如EnvironmentRepository、ResourceRepository）获取配置资源，适配响应式请求模型。
• 拆分部署：将Config Server拆分为两个实例，一个用Servlet栈处理资源请求，一个用WebFlux栈处理Environment相关请求，通过路由规则分配流量（适合复杂场景）。

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