使用 Axios 处理 Server-Sent Events (SSE) 数据流-js教程-PHP中文网

使用 Axios 处理 Server-Sent Events (SSE) 数据流

DDD

发布： 2025-09-24 19:11:21

原创

381人浏览过

使用 axios 处理 server-sent events (sse) 数据流

本文旨在指导开发者如何在前端使用 Axios 处理 Server-Sent Events (SSE) 数据流，特别是在需要使用 POST 方法发送数据的情况下。文章将介绍一种基于 fetch-event-source 框架的解决方案，并提供其他可选方案，包括纯 JavaScript + Axios 的实现方式以及后端 Java (Spring) 的实现示例，以帮助读者全面理解和应用 SSE 技术。

前端处理 SSE 数据流

Server-Sent Events (SSE) 是一种允许服务器单向推送数据到客户端的技术，非常适合实时更新的应用场景。虽然 EventSource API 是处理 SSE 的标准方法，但它不支持 POST 请求。因此，当需要使用 POST 方法与 SSE API 交互时，我们需要寻找替代方案。

方案一：使用 fetch-event-source 框架

fetch-event-source 是一个强大的 JavaScript 库，它基于 fetch API，提供了对 SSE 的支持，并且可以灵活地处理各种 HTTP 方法，包括 POST。

安装：

虽然原文没有给出安装方式，但通常可以通过 npm 或 yarn 安装：

npm install fetch-event-source
# 或者
yarn add fetch-event-source

登录后复制

使用示例：

import { fetchEventSource } from '@microsoft/fetch-event-source';

const data = {
  model: "gpt-3.5-turbo",
  prompt: "Say this is a test",
  max_tokens: 7,
  stream: true,
  temperature: 0
};

fetchEventSource('/my-service/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'text/event-stream', // 明确指定 Accept 类型
    'SESSION_ID': 'Header-Value'
  },
  body: JSON.stringify(data),
  onmessage(event) {
    console.log("Received event:", event.data); // 处理接收到的数据
  },
  onerror(err) {
    console.error("Error:", err);
  },
  onclose() {
    console.log("Connection closed");
  }
});

登录后复制

注意事项：

确保后端正确设置了 Content-Type 为 text/event-stream。
fetchEventSource 提供了一系列回调函数，例如 onmessage、onerror 和 onclose，用于处理不同的事件。
body 必须是序列化后的 JSON 字符串。

方案二：纯 JavaScript + Axios 实现

另一种方法是结合使用 Axios 和 onDownloadProgress 回调函数，手动处理数据流。这种方法相对复杂，但可以避免引入额外的依赖。

怪兽AI数字人

数字人短视频创作，数字人直播，实时驱动数字人

查看详情

axios({
  url: '/my-service/chat', // 替换为你的API端点
  data: {
    prompt: 'json data'
  },
  headers: {
    'accept': 'text/event-stream', // 明确指定 Accept 类型
    'content-type': 'application/json'
  },
  method: 'POST',
  responseType: 'stream', // 重要: 指定 responseType 为 'stream'
  onDownloadProgress: progressEvent => {
    const xhr = progressEvent.event.target;
    const { responseText } = xhr;
    console.log("=====responseText======");
    console.log(responseText);
    // 在这里处理接收到的数据流，例如解析 SSE 格式的数据
  }
}).then(({ data }) => Promise.resolve(data));

登录后复制

注意事项：

responseType 必须设置为 stream，否则 Axios 不会触发 onDownloadProgress 回调。
onDownloadProgress 回调函数会多次触发，每次触发时 responseText 包含的是当前已接收到的所有数据。因此，你需要自行解析 SSE 格式的数据，并处理不完整的数据块。
这种方法对数据格式的依赖性较强，需要确保后端返回的数据符合 SSE 规范。

后端 Java (Spring) 实现示例

以下是使用 Spring Boot 创建 SSE 端点的示例代码：

import org.springframework.http.MediaType;
import org.springframework.http.codec.ServerSentEvent;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Flux;

import java.time.Duration;
import java.time.LocalTime;

@RestController
public class SSEController {

    @GetMapping(value = "/stream-sse", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
    public Flux<ServerSentEvent<String>> streamSse() {
        return Flux.interval(Duration.ofSeconds(1))
                .map(sequence -> ServerSentEvent.<String>builder()
                        .id(String.valueOf(sequence))
                        .event("periodic-event")
                        .data("Server time: " + LocalTime.now())
                        .build());
    }
}

登录后复制

解释：

@GetMapping(value = "/stream-sse", produces = MediaType.TEXT_EVENT_STREAM_VALUE) 定义了一个处理 /stream-sse 请求的端点，并指定 produces 为 MediaType.TEXT_EVENT_STREAM_VALUE，表示返回 SSE 数据流。
Flux.interval(Duration.ofSeconds(1)) 创建一个每秒发送一次数据的流。
ServerSentEvent.builder() 用于构建 SSE 事件，可以设置 id、event 和 data 等属性。

客户端测试：

可以使用 WebClient 测试该端点：

import org.springframework.http.codec.ServerSentEvent;
import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Flux;

import java.time.LocalTime;

public class SSEClient {
    public static void main(String[] args) {
        WebClient client = WebClient.create("http://localhost:8080");

        Flux<ServerSentEvent<String>> eventStream = client.get()
                .uri("/stream-sse")
                .retrieve()
                .bodyToFlux(ServerSentEvent.class);

        eventStream.subscribe(
                content -> System.out.println("Time: " + LocalTime.now() + " - event: name[" + content.event() + "], id [" + content.id() + "], content[" + content.data() + "] "),
                error -> System.err.println("Error receiving SSE: " + error),
                () -> System.out.println("Completed!!!"));

        // Keep the application running for a while to receive events
        try {
            Thread.sleep(10000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}

登录后复制

总结

本文介绍了在前端使用 Axios 处理 SSE 数据流的两种主要方法：使用 fetch-event-source 框架和使用纯 JavaScript + Axios。fetch-event-source 提供了更简洁易用的 API，而纯 JavaScript + Axios 则更加灵活，但需要手动处理数据流的解析。同时，文章也提供了后端 Java (Spring) 实现 SSE 端点的示例，帮助开发者构建完整的 SSE 应用。选择哪种方法取决于具体的应用场景和需求。在选择时，请考虑以下因素：