Spring WebFlux 功能介绍，使用场景，完整使用示例

原创 于 2025-06-24 17:09:38 发布 · 489 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java

Spring WebFlux 是 Spring Framework 5+ 引入的非阻塞、响应式 Web 框架，旨在充分利用现代多核处理器和异步 I/O 模型（如 Netty、Undertow、Servlet 3.1+ 容器），处理海量并发连接，特别适合低延迟、高吞吐量的应用场景。它是 Spring MVC 的补充，为响应式编程模型提供了完整的支持。

核心功能：

  1. 非阻塞 & 响应式核心：

    • 基于 Project Reactor（Reactive Streams 规范的实现），使用 Flux (0…N 个元素) 和 Mono (0…1 个元素) 作为核心响应式类型。
    • 整个请求处理链（Controller -> Service -> DAO）在事件循环线程上运行，避免了为每个请求分配一个线程的传统阻塞模型，极大减少线程上下文切换开销和内存消耗。
    • 通过异步 I/O 操作（如网络调用、数据库访问）释放线程，让线程去处理其他请求，提高资源利用率。

  2. 函数式编程模型：

    • 基于注解的控制器 (@Controller, @RestController): 与 Spring MVC 风格类似，但方法返回类型是 Mono/Flux/Mono<Void> 等响应式类型。
    • 函数式端点 (Router Functions): 提供轻量级、函数式的编程模型，通过 RouterFunction 和 HandlerFunction 定义路由和处理逻辑，更显式地控制请求处理流程，减少注解开销。

  3. 响应式 HTTP 客户端 (WebClient):

    • 非阻塞、响应式的 HTTP 客户端，替代传统的阻塞式 RestTemplate。
    • 提供流畅的 API 进行声明式调用，支持异步、流式数据处理和背压。

  4. 响应式 WebSocket 支持：

    • 提供处理 WebSocket 连接的 API，支持双向、全双工的流式通信，返回和消费 Flux/Mono。

  5. 响应式 Server-Sent Events (SSE) 支持：

    • 轻松实现服务器向客户端单向推送事件流的功能，控制器方法可以直接返回 Flux<ServerSentEvent>。

  6. 与响应式数据存储集成：

    • 与响应式数据库驱动（如 R2DBC for SQL, Reactive MongoDB, Reactive Cassandra, Reactive Redis）和响应式消息队列（如 Reactor Kafka, RabbitMQ Reactor）无缝集成。

  7. 背压 (Backpressure) 支持：

    • 响应式流的核心机制，允许消费者控制生产者的速度，防止下游被上游过快的数据淹没，确保系统稳定。

主要使用场景：

  1. 高并发 & 高吞吐量应用： 需要处理成千上万甚至百万级并发连接的场景（如实时聊天、游戏服务器、金融交易平台、物联网数据采集网关）。
  2. 低延迟要求： 需要极快响应时间的应用，非阻塞模型减少了线程阻塞带来的延迟。
  3. 流式数据处理： 处理持续不断的实时数据流（如传感器数据、日志流、股票行情、视频流处理）。
  4. 异步 & 非阻塞 I/O 密集型服务： 服务的主要瓶颈在于等待外部资源响应（如微服务间调用、数据库查询、外部 API 调用）。
  5. 资源受限环境： 需要节省内存和 CPU 资源的场景（如云原生环境、容器化部署），因为 WebFlux 通常比线程阻塞模型使用更少的线程。
  6. 构建响应式系统： 作为构建端到端响应式微服务架构的 Web 层组件。

何时 不 首选 WebFlux？

  • 简单 CRUD 应用： 并发量不高，使用熟悉的 Spring MVC + 阻塞式数据库驱动开发更快、更简单。
  • 强事务性、复杂阻塞逻辑： 如果业务逻辑本身是重度计算密集型（CPU Bound）或者必须依赖阻塞式库（如 JDBC）且难以替换，强行用 WebFlux 可能收益不大甚至引入复杂度。
  • 团队缺乏响应式经验： 响应式编程范式（如函数式、声明式、异步流处理）学习曲线较陡峭，调试也更复杂。

完整使用示例 (基于注解的 Controller + Reactive MongoDB + WebClient)

1. 依赖 (Maven - pom.xml):

<dependencies>
    <!-- Spring Boot Starter WebFlux -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webflux</artifactId>
    </dependency>

    <!-- Spring Data Reactive MongoDB -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-mongodb-reactive</artifactId>
    </dependency>

    <!-- Project Reactor (通常由 starter 带进来) -->
    <dependency>
        <groupId>io.projectreactor</groupId>
        <artifactId>reactor-core</artifactId>
    </dependency>
</dependencies>

2. 实体类 (User.java):

@Data
@NoArgsConstructor
@AllArgsConstructor
@Document(collection = "users") // MongoDB 集合映射
public class User {
    @Id
    private String id;
    private String name;
    private String email;
}

3. 响应式 Repository (UserRepository.java):

public interface UserRepository extends ReactiveMongoRepository<User, String> {
    Flux<User> findByName(String name); // 响应式查询方法
}

4. Service 层 (UserService.java):

@Service
public class UserService {

    private final UserRepository userRepository;
    private final WebClient webClient; // 响应式 HTTP 客户端

    public UserService(UserRepository userRepository, WebClient.Builder webClientBuilder) {
        this.userRepository = userRepository;
        this.webClient = webClientBuilder.baseUrl("http://some-external-api.com").build();
    }

    public Flux<User> getAllUsers() {
        return userRepository.findAll();
    }

    public Mono<User> getUserById(String id) {
        return userRepository.findById(id);
    }

    public Mono<User> createUser(User user) {
        return userRepository.save(user);
    }

    public Mono<User> updateUser(String id, User user) {
        return userRepository.findById(id)
                .flatMap(existingUser -> {
                    existingUser.setName(user.getName());
                    existingUser.setEmail(user.getEmail());
                    return userRepository.save(existingUser);
                });
    }

    public Mono<Void> deleteUser(String id) {
        return userRepository.deleteById(id);
    }

    // 示例：使用 WebClient 调用外部API并处理响应
    public Mono<String> fetchDataFromExternalApi() {
        return webClient.get()
                .uri("/data")
                .retrieve()
                .bodyToMono(String.class)
                .onErrorResume(e -> Mono.just("Fallback Data")); // 错误处理示例
    }
}

5. Controller 层 (UserController.java):

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

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    // 获取所有用户 (返回 Flux<User>)
    @GetMapping
    public Flux<User> getAllUsers() {
        return userService.getAllUsers();
    }

    // 根据ID获取用户 (返回 Mono<User>)
    @GetMapping("/{id}")
    public Mono<ResponseEntity<User>> getUserById(@PathVariable String id) {
        return userService.getUserById(id)
                .map(user -> ResponseEntity.ok(user)) // 找到用户，返回200 OK
                .defaultIfEmpty(ResponseEntity.notFound().build()); // 用户不存在，返回404
    }

    // 创建用户 (接受 Mono<User> 请求体，返回 Mono<User>)
    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Mono<User> createUser(@RequestBody Mono<User> userMono) {
        return userMono.flatMap(userService::createUser);
    }

    // 更新用户
    @PutMapping("/{id}")
    public Mono<ResponseEntity<User>> updateUser(@PathVariable String id, @RequestBody Mono<User> userMono) {
        return userMono.flatMap(user -> userService.updateUser(id, user))
                .map(updatedUser -> ResponseEntity.ok(updatedUser))
                .defaultIfEmpty(ResponseEntity.notFound().build());
    }

    // 删除用户 (返回 Mono<Void> 表示操作完成)
    @DeleteMapping("/{id}")
    @ResponseStatus(HttpStatus.NO_CONTENT)
    public Mono<Void> deleteUser(@PathVariable String id) {
        return userService.deleteUser(id);
    }

    // 示例：Server-Sent Events (SSE) 端点 - 模拟持续发送用户列表更新
    @GetMapping(value = "/stream", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
    public Flux<User> streamUserUpdates() {
        return Flux.interval(Duration.ofSeconds(1)) // 每秒触发一次
                .flatMap(tick -> userService.getAllUsers().take(5)); // 每次发送前5个用户（模拟更新）
    }

    // 示例：调用外部API
    @GetMapping("/external-data")
    public Mono<String> getExternalData() {
        return userService.fetchDataFromExternalApi();
    }
}

6. 配置 (application.properties or application.yml):

# MongoDB 连接配置
spring.data.mongodb.uri=mongodb://localhost:27017/mydatabase

# (可选) 设置 Netty 作为内嵌服务器 (默认通常是 Netty)
server.port=8080

示例说明：

  1. 依赖： 引入了 WebFlux、响应式 MongoDB 和 Reactor 的核心依赖。
  2. 实体 & Repository： 定义了 User 实体和响应式的 Spring Data MongoDB Repository 接口。
  3. Service：
    • 注入 UserRepository 进行响应式数据库操作 (findAll, findById, save, deleteById)。
    • 注入 WebClient (通过 WebClient.Builder 构造) 用于进行非阻塞的 HTTP 调用。fetchDataFromExternalApi 方法展示了基本用法和错误处理 (onErrorResume)。
    • 所有 Service 方法返回 Flux 或 Mono。
  4. Controller：
    • 使用 @RestController 和 @RequestMapping 定义 REST 端点。
    • 方法参数可以接受 @RequestBody Mono<User> 表示请求体是异步到达的。
    • 方法返回类型都是 Flux 或 Mono。
    • getUserById 和 updateUser 展示了如何处理可能为空的结果，返回不同的 ResponseEntity 状态码。
    • deleteUser 返回 Mono<Void> 并设置 @ResponseStatus(HttpStatus.NO_CONTENT)。
    • streamUserUpdates 方法：
      • 设置 produces = MediaType.TEXT_EVENT_STREAM_VALUE 表明这是一个 SSE 端点。
      • 使用 Flux.interval 每秒生成一个信号。
      • 每次信号触发时，调用 userService.getAllUsers().take(5) 获取（模拟的）最新用户数据（这里简单取了前5个）并发送给客户端。客户端会持续接收到事件流。
    • getExternalData 方法展示了如何在 Controller 中调用 Service 层的 WebClient 功能。
  5. 运行： 启动 Spring Boot 应用。应用默认会使用 Netty 作为内嵌服务器。可以使用 curl, Postman 或浏览器（对于 /api/users/stream）测试各个端点。

关键注意事项：

  1. 非阻塞贯穿始终： 从 Controller 到 Service 到 Repository (或 WebClient) 的整个调用链必须是响应式和非阻塞的。如果在其中任何一环使用了阻塞操作（如传统的 JDBC 调用、Thread.sleep()、同步 IO），会破坏响应式模型的优势，甚至可能导致性能下降或线程饥饿。
  2. 学习曲线： 响应式编程范式（Flux, Mono, 操作符如 map, flatMap, filter, zip, onErrorResume 等）需要学习和适应。
  3. 调试： 调试响应式流比调试传统的命令式代码更具挑战性，堆栈跟踪可能不那么直观。利用 Reactor 的调试工具（如 Hooks.onOperatorDebug()）和日志记录很重要。
  4. 现有库兼容性： 确保你使用的所有库（数据库驱动、HTTP 客户端、消息队列客户端等）都有响应式版本或支持非阻塞操作。使用阻塞库会破坏响应式链。
  5. 背压理解： 理解背压机制以及如何在你的应用中正确处理它是构建健壮响应式系统的关键。

总结：

Spring WebFlux 是一个强大的框架，为构建高性能、可扩展、资源高效的异步和非阻塞 Web 应用程序和微服务提供了现代解决方案。它特别适合处理高并发、低延迟和流式数据场景。在决定采用 WebFlux 时，务必权衡其优势（性能、可伸缩性）与挑战（学习曲线、调试、库兼容性），确保它适合你的具体应用需求和团队技能。上面的完整示例展示了如何使用注解模型结合响应式 MongoDB 和 WebClient 构建一个基本的 CRUD API，并包含 SSE 和外部 API 调用的示例。

Spring WebFlux 介绍与效果演示示例
oscar999的专栏
07-21 447
响应式编程Spring WebFlux 使用响应式编程的理念，其中数据流和异步操作是核心概念。这种编程范式适用于高并发、高吞吐量的场景，允许应用程序以非阻塞的方式处理请求，并有效地利用服务器资源。它使用 Reactor 框架作为响应式编程的核心库，通过事件驱动和异步操作来处理请求和数据流。非阻塞和异步处理Spring WebFlux 支持异步和非阻塞的处理方式，这使得它能够处理高负载的情况，如即时通讯、实时数据推送等。
深入解析 Spring WebFlux：原理与应用
程序猿进阶
12-23 9314
WebFlux 是 Spring Framework 5 引入的一种响应式编程框架，和Spring MVC同级，旨在处理高并发和低延迟的非阻塞应用。这是一个支持反应式编程模型的新Web框架体系。顺便一提，Spring Cloud Gateway在实现上是对Spring WebFlux的拓展。
Spring5 WebFlux响应式编程应用场景示例
老码农的博客
12-27 2222
Spring5中重要的变化是把响应式编程的思想应用到了框架的各个方面如Spring WebFlux, Spring Data和Spring Cloud Gateway。Spring5 的响应式编程默认以Reactor库为基础。Reactor内部提供了Flux和Mono两个代表异步数据系列的核心组件，它使开发人员能够方便快捷的构建异步非阻塞的应用程序。
Spring WebFlux 与 WebClient 使用指南
千层冷面的博客
05-13 1478
WebClient 是 Spring WebFlux 模块提供的非阻塞、响应式 HTTP 客户端，基于 Project Reactor 实现，适用于高并发场景
Spring Boot 3.4.3 基于 Spring WebFlux 实现 SSE 功能
lssffy的博客
03-30 1183
SSE（Server-Sent Events）是一种基于 HTTP 协议的服务器推送技术，允许服务器主动向客户端发送数据。客户端通过建立长连接接收服务器推送的事件流，适用于需要实时更新的场景。与 WebSocket 相比，SSE 是单向通信（仅服务器到客户端），实现更简单，且浏览器原生支持。Spring WebFlux 是 Spring 5 引入的响应式 Web 框架，与传统的 Spring MVC 不同，它基于 Reactor 项目，支持异步非阻塞的编程模型。
Spring WebFlux 教程
kalle2021的博客
03-24 1007
Spring WebFlux 是 Spring Framework 5 的反应式编程框架，基于 Reactor ，以非阻塞、事件驱动模型提升资源利用率，适配高并发与实时数据处理。 本文介绍基础概念，对比 WebFlux 与 Web MVC ；阐述环境搭建与依赖配置。通过多个示例展示简单 WebFlux 应用构建，涵盖控制器、数据模型。深入分析高级特性，如反应式数据库操作、异常处理、实时数据流、与 Spring Security 集成。还以反应式博客系统为例，并给出常见问题解决方案 。
Spring WebFlux 详解
weixin_41204608的博客
07-23 174
Spring WebFlux框架Spring WebFlux是Spring 5发布的响应式Web框架，从SpringBoot 2.x开始，默认采用Netty作为非阻塞I/O的Web服务器。Spring WebFlux概述Spring WebFlux基于Reactor框架，同时支持RxJava类库，构建响应式编程框架。查看W...
Spring WebFlux入门
weixin_44692308的博客
08-01 1129
WebFlux 是 Spring 5 的一部分，支持响应式编程的 Web 框架。它基于 Project Reactor，提供了一种非阻塞的方式来处理请求和响应。与传统的 Servlet 模型不同，WebFlux 允许在执行 I/O 操作时不阻塞线程，从而提高系统的吞吐量。WebFlux 强调的是响应式编程，它通过 Flux 和 Mono 提供了简单的方式来处理异步数据流。相较于传统的 Servlet 模型，WebFlux 更加高效，特别适合高并发场景。
Spring WebFlux与Spring MVC
m0_73837751的博客
11-30 2073
部分的一种替代选择，主要是为了解决现代 Web 应用在高并发和低延迟场景下的性能瓶颈。是对 Spring Boot 项目中传统。
Java reactive programming - Reactor 3 and Spring WebFlux
07-03
以下是一个使用 Spring WebFlux 构建简单 REST API 的示例： ```java import org.springframework.web.reactive.function.server.RouterFunction; import org.springframework.web.reactive.function.server.Server...
sample-spring-cloud-webflux：示例微服务，演示了如何通过spring webflux和集成spring spring，eureka，ribbon，spring cloud gateway，spring data jpa和mongodb使用springReact支持
02-04
总的来说，"sample-spring-cloud-webflux"项目是一个全面展示如何使用现代技术和工具构建微服务的示例。通过学习这个项目，开发者不仅可以掌握Spring WebFlux的反应式编程，还能了解到Spring Cloud生态中的核心组件...
Java虚拟机解剖：从字节码到机器指令的终极之旅（六）
ldwtxwh的专栏
06-20 1166
/ 实现自定义自旋策略@Overridefor (;;= 0) {// 自适应自旋64 : 0;// 使用CPU等待指令continue;// CAS获取锁@Override// 写操作后插入StoreLoad屏障acquire(1);release(1);// 测试用例// 启动10个线程i < 10;t.start();
「Java EE开发指南」如何用MyEclipse创建一个WEB项目？（二）
需要界面开发、IDE工具研发中文教程资料的小伙伴，记得私信我~
06-23 369
本教程将为大家介绍如何使用MyEclipse创建一个WEB项目，欢迎下载最新版IDE体验！
【C#】C#中的Type类详解
德仔
06-23 861
C#中的Type类是System命名空间的核心组件，为.NET反射系统提供基础支持。它作为抽象基类，表示各种类型声明，并提供类型元数据访问，包括属性、方法等成员信息。获取Type对象可通过typeof运算符、实例GetType方法或类型名称查找。Type类包含Name、Namespace等关键属性，以及GetMethods()等方法，支持动态类型检查、对象创建、成员调用等反射操作。在插件系统和动态编程中尤为实用，但需注意反射带来的性能开销、安全风险和维护复杂性。合理使用Type类可以增强代码灵活性，但性能敏
梯度下降路径平滑算法详解（C++）
zxy_ZXY123的博客
06-19 1315
本问主要基于梯度下降平滑算法进行总结分析。
springboot中表是以int为主键id的，写了一个生成不重复id的方法
weixin_46528266的博客
06-23 531
springboot中表是以int为主键id的，写了一个生成不重复id的方法
Java+GcExcel，生成自定义工作表
葡萄城技术团队博客
06-24 503
GcExcel Java为Java开发人员提供了强大的电子表格处理能力，能够高效创建、操作和转换兼容Excel的工作表。该组件具有低内存占用、450+公式计算支持、多格式输出（xlsx/pdf等）以及模板批量生成等特性，适用于Web/桌面/云平台等多种环境。开发人员可通过API实现工作表显示配置、选项卡颜色设置、可见性管理、背景图片添加等自定义功能，还能创建独特的命名样式。GcExcel Java简化了复杂电子表格需求的处理流程，帮助开发者在各类应用中快速生成专业级报表。
day12——面向对象进阶：匿名内部类、泛型、枚举
最新发布
白元霞的博客
06-24 616
容器类示例// 编译错误特性主要用途使用场景示例注意事项成员内部类访问外部类私有成员汽车-发动机关系避免过度嵌套静态内部类独立于外部类实例工具类中的辅助类不能访问外部类实例成员匿名内部类快速实现接口/抽象类事件监听、线程创建复杂逻辑可读性差枚举类型安全的常量定义状态码、有限状态机、配置选项适合固定选项集合泛型类创建类型安全的容器自定义集合类、包装类避免类型擦除陷阱泛型方法方法级别类型安全工具方法、工厂方法灵活但增加理解难度最佳实践提示。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值