Docs

外观

Spring WebFlux

约 331 字大约 1 分钟

2026-05-16

Spring WebFlux 是 Spring 5 引入的响应式 Web 框架，基于 Reactor，适合高并发 IO、流式响应和非阻塞调用场景。

一、核心概念

概念说明
Mono表示 0 或 1 个异步结果
Flux表示 0 到 N 个异步结果
ReactorSpring WebFlux 默认响应式库
WebClient非阻塞 HTTP 客户端
Netty常见非阻塞运行时

二、MVC 与 WebFlux

对比项Spring MVCSpring WebFlux
编程模型同步阻塞响应式非阻塞
线程模型请求线程处理到底少量线程处理大量 IO
返回类型普通对象、集合Mono、Flux
适用场景常规业务系统高并发 IO、流式处理
学习成本低较高

三、Controller 示例

@RestController
@RequestMapping("/api/users")
public class UserHandler {

    @GetMapping("/{id}")
    public Mono<User> getUser(@PathVariable Long id) {
        return userService.findById(id);
    }

    @GetMapping
    public Flux<User> listUsers() {
        return userService.findAll();
    }
}

四、WebClient

WebClient 是非阻塞 HTTP 客户端，也可以在 MVC 项目中使用。

WebClient client = WebClient.builder()
    .baseUrl("http://user-service")
    .build();

Mono<User> user = client.get()
    .uri("/api/users/{id}", id)
    .retrieve()
    .bodyToMono(User.class);

五、使用建议

  • 不要只因为“高性能”就盲目改用 WebFlux。
  • 如果数据库驱动、Redis、外部 SDK 都是阻塞的，整体收益会明显下降。
  • WebFlux 适合完整链路都能响应式化的场景。
  • 普通 CRUD 后台系统优先选 Spring MVC。