SpringBoot SSE服务端开发避坑指南：当客户端突然断开时SseEmitter的正确处理姿势

最新推荐文章于 2026-02-25 13:54:54 发布

原创

最新推荐文章于 2026-02-25 13:54:54 发布 · 554 阅读

标签

#SpringBoot #SSE #SseEmitter #服务器推送

SpringBoot SSE服务端开发深度实践：连接中断与资源管理的终极解决方案

1. SSE技术核心原理与SpringBoot实现机制

Server-Sent Events（SSE）作为一种轻量级的服务器推送技术，在现代Web应用中扮演着越来越重要的角色。与WebSocket不同，SSE建立在HTTP协议之上，采用简单的文本格式进行单向通信，特别适合需要服务器向客户端持续推送数据的场景。

SpringBoot对SSE的原生支持主要通过SseEmitter类实现，这个类本质上是对异步请求处理的封装。当客户端发起SSE连接时，服务端并不立即关闭HTTP响应，而是保持连接打开状态，通过这个持久的HTTP连接持续发送事件流。

关键工作机制：

连接建立：客户端通过EventSource发起请求，服务端创建SseEmitter实例
事件推送：服务端通过emitter.send()方法发送格式化的文本事件
连接维持：默认情况下连接会保持打开，直到超时或显式关闭
异常处理：内置onCompletion、onTimeout和onError回调机制

@GetMapping("/stream")
public SseEmitter streamData() {
    SseEmitter emitter = new SseEmitter(30_000L); // 设置30秒超时
    
    emitter.onCompletion(() -> log.info("连接正常结束"));
    emitter.onTimeout(() -> log.info("连接超时"));
    emitter.onError((ex) -> log.error("连接异常", ex));
    
    // 模拟异步事件推送
    CompletableFuture.runAsync(() -> {
        try {
            for (int i = 0; i < 10; i++) {
                emitter.send(SseEmitter.event()
                    .id(String.valueOf(i))
                    .name("message")
                    .data("Event " + i));
                Thread.sleep(1000);
            }
            emitter.complete();
        } catch (Exception e) {
            emitter.completeWithError(e);
        }
    });
    
    return emitter;
}