如何使用 SseEmitter 实现 Spring Boot 后端的流式传输和前端的数据接收

 更新时间:2025年05月08日 09:47:06   作者:小张学Ai  
SseEmitter 是 Spring Web 提供的一个用于服务器推送事件(SSE, Server-Sent Events)的工具,它可以让服务器端不断向客户端推送数据,而不需要客户端不断轮询,本文将介绍如何使用 SseEmitter 创建流式传输,并实现后端与前端的高效交互,感兴趣的朋友一起看看吧

使用 SseEmitter 实现 Spring Boot 后端的流式传输和前端的数据接收

在构建现代 Web 应用时,实时数据推送是一个非常重要的需求,比如 AI 对话流式响应、实时通知推送等。而在 Spring Boot 中,SseEmitter 是一个非常方便的工具,它可以让后端向前端进行流式数据传输(Server-Sent Events,简称 SSE)。本文将介绍如何使用 SseEmitter 创建流式传输,并实现后端与前端的高效交互。

1. 什么是 SseEmitter?

SseEmitter 是 Spring Web 提供的一个用于服务器推送事件(SSE, Server-Sent Events)的工具。它可以让服务器端不断向客户端推送数据,而不需要客户端不断轮询。

相比于 WebSocket,SSE 具有以下优点:

  • 基于 HTTP 连接,无需额外的协议支持,前端可以直接使用 EventSource 进行接收。
  • 支持自动重连,如果连接断开,浏览器会自动尝试重新建立连接。
  • 更适合单向推送数据的场景,如 AI 生成流式文本、服务器消息推送等。

2. 在 Spring Boot 中使用 SseEmitter

2.1 添加依赖

如果你的项目使用的是 Spring MVC,无需额外的依赖。但如果你使用的是 Spring WebFlux,请确保你的 pom.xml 中包含以下依赖(仅 WebFlux 需要):

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

2.2 创建后端流式接口

java的代码示例如下:

@RestController
@RequestMapping("/api/chat")
public class ChatController {
    @GetMapping("/stream")
    public SseEmitter streamResponse() {
        SseEmitter emitter = new SseEmitter(0L); // 0L 表示永不超时
        Executors.newSingleThreadExecutor().execute(() -> {
            try {
                for (int i = 1; i <= 5; i++) {
                    emitter.send("消息 " + i);
                    Thread.sleep(1000); // 模拟延迟
                }
                emitter.complete();
            } catch (Exception e) {
                emitter.completeWithError(e);
            }
        });
        return emitter;
    }
}

3. 前端如何接收流式数据

📌 使用 fetch 处理 SSE(流式数据),fetch 默认不会处理流式数据,因此我们需要手动解析 ReadableStream 以逐步接收数据。

✅ 前端代码(基于 fetch/infetch)

async function fetchStreamData() {
    const response = await fetch("/api/chat/stream");
    // 确保服务器支持流式数据
    if (!response.ok) {
        throw new Error(`HTTP 错误!状态码: ${response.status}`);
    }
    const reader = response.body.getReader();
    const decoder = new TextDecoder("utf-8");
    // 读取流式数据
    while (true) {
        const { done, value } = await reader.read();
        if (done) break;
        // 解码并输出数据
        const text = decoder.decode(value, { stream: true });
        console.log("收到数据:", text);
    }
    console.log("流式传输完成");
}
// 调用流式请求
fetchStreamData().catch(console.error);

📌 为什么使用 fetch + ReadableStream?

  • 兼容性更好:fetch API 是现代浏览器的标准方法,相比 EventSource 可处理更多类型的流式数据(如 JSON、HTML、二进制)。
  • 更灵活:可以手动控制数据读取,支持自定义解析方式。
  • 适用于 AI 大模型返回:如果你的后端是 ChatGPT/DeepSeek API 这样的 AI 接口,fetch + stream 是最佳方式。

到此这篇关于使用 SseEmitter 实现 Spring Boot 后端的流式传输和前端的数据接收的文章就介绍到这了,更多相关Spring Boot SseEmitter流式传输和数据接收内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java 数组内置函数toArray详解

    Java 数组内置函数toArray详解

    这篇文章主要介绍了Java 数组内置函数toArray详解,文本详细的讲解了toArray底层的代码和文档,需要的朋友可以参考下
    2021-06-06
  • Spring+SpringMVC+MyBatis深入学习及搭建(二)之MyBatis原始Dao开发和mapper代理开发

    Spring+SpringMVC+MyBatis深入学习及搭建(二)之MyBatis原始Dao开发和mapper代理开发

    这篇文章主要介绍了Spring+SpringMVC+MyBatis深入学习及搭建(二)之MyBatis原始Dao开发和mapper代理开发,需要的朋友可以参考下
    2017-05-05
  • Java并发Futures和Callables类实例详解

    Java并发Futures和Callables类实例详解

    Callable对象返回Future对象,该对象提供监视线程执行的任务进度的方法, Future对象可用于检查Callable的状态,然后线程完成后从Callable中检索结果,这篇文章给大家介绍Java并发Futures和Callables类的相关知识,感兴趣的朋友一起看看吧
    2024-05-05
  • spring学习之util:properties的使用

    spring学习之util:properties的使用

    这篇文章主要介绍了spring学习之util:properties的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01
  • JustAuth整合第三方登录组件样例

    JustAuth整合第三方登录组件样例

    这篇文章主要为大家介绍了JustAuth整合第三方登录组件样例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-07-07
  • 使用java实现猜拳小游戏

    使用java实现猜拳小游戏

    这篇文章主要为大家详细介绍了使用java实现猜拳小游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-07-07
  • Java服务器端跨域问题解决方案

    Java服务器端跨域问题解决方案

    这篇文章主要介绍了java服务器端跨域问题解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-01-01
  • 在java中由类名和方法名字符串实现其调用方式

    在java中由类名和方法名字符串实现其调用方式

    这篇文章主要介绍了在java中由类名和方法名字符串实现其调用方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • Kafka中消息队列的两种模式讲解

    Kafka中消息队列的两种模式讲解

    这篇文章主要介绍了Kafka中消息队列的两种模式讲解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-05-05
  • Java多线程之线程安全问题详情

    Java多线程之线程安全问题详情

    这篇文章主要介绍了Java多线程之线程安全问题详情,线程安全问题是指因多线程抢占式执行而导致程序出现bug的问题。内容介绍详细内容需要的小伙伴可以参考下面文章内容
    2022-06-06

最新评论