莱夢1. 什么是SSE？为什么选择它？
SSE（Server-Sent Events）是一种基于HTTP的服务器推送技术，它允许服务器单向向客户端发送事件流。与WebSocket不同，SSE是HTTP协议的一部分，使用简单的文本格式传输数据。
我第一次接触SSE是在开发一个实时股票行情展示系统时。当时面临的选择是WebSocket还是SSE，最终选择了SSE，原因很简单：它更轻量级，实现更简单，而且完全基于HTTP协议，不需要额外的协议升级握手。
提示：SSE特别适合那些只需要服务器向客户端推送数据的场景，比如新闻推送、股票行情、实时日志等。
SSE的工作原理其实很简单：客户端通过EventSource API建立一个持久连接，服务器保持这个连接打开，并通过"text/event-stream"格式不断发送数据。每个事件由一行或多行文本组成，以两个换行符结束。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Spring中的SSE实现核心类
在Spring框架中，SSE的核心实现类是SseEmitter。这个类封装了SSE的所有功能，让我们可以非常方便地在Spring应用中实现服务器推送。
2.1 SseEmitter的基本用法
创建一个简单的SSE端点非常简单：
java复制@GetMapping("/stream")
public SseEmitter streamEvents() {
SseEmitter emitter = new SseEmitter();
// 在这里发送事件
return emitter;
}
SseEmitter有几个重要的方法：
send(): 发送事件数据complete(): 完成事件流onCompletion(): 设置完成回调onTimeout(): 设置超时回调
2.2 SseEmitter的配置选项
SseEmitter有几个重要的配置参数：
java复制// 设置超时时间（毫秒）
SseEmitter emitter = new SseEmitter(30_000L);
// 设置重试时间（客户端断开后多久重连）
emitter.send(SseEmitter.event().reconnectTime(5000));
在实际项目中，我发现超时时间的设置非常重要。太短会导致频繁重连，太长则可能占用过多服务器资源。根据我的经验，30秒到2分钟是一个比较合理的范围。
3. 完整SSE服务端实现
让我们来看一个完整的SSE服务端实现示例。这个例子模拟了一个实时温度监控系统。
3.1 控制器实现
java复制@RestController
@RequestMapping("/api/sse")
public class SseController {
private final ExecutorService executor = Executors.newCachedThreadPool();
@GetMapping("/temperature")
public SseEmitter streamTemperature() {
SseEmitter emitter = new SseEmitter(60_000L);
executor.execute(() -> {
try {
for (int i = 0; i < 100; i++) {
double temperature = 20 + Math.random() * 10;
emitter.send(SseEmitter.event()
.id(String.valueOf(i))
.name("temperature")
.data(temperature)
.reconnectTime(3000));
Thread.sleep(1000);
}
emitter.complete();
} catch (Exception ex) {
emitter.completeWithError(ex);
}
});
emitter.onCompletion(() -> System.out.println("SSE completed"));
emitter.onTimeout(() -> System.out.println("SSE timeout"));
return emitter;
}
}
3.2 事件数据格式
SSE事件的标准格式如下：
code复制id: 123
event: temperature
data: 25.3
retry: 3000
在Spring中，SseEmitter帮我们处理了这些格式细节，我们只需要关注业务数据即可。
4. 客户端实现
SSE的客户端实现非常简单，现代浏览器都原生支持EventSource API。
4.1 基本客户端代码
javascript复制const eventSource = new EventSource('/api/sse/temperature');
eventSource.addEventListener('temperature', (event) => {
const data = JSON.parse(event.data);
console.log(`Current temperature: ${data}`);
});
eventSource.onerror = (err) => {
console.error("EventSource failed:", err);
};
4.2 客户端注意事项
在实际项目中，我发现有几个常见问题需要注意：
-
连接管理：当页面切换或不再需要数据时，记得调用
eventSource.close()关闭连接。 -
错误处理：SSE会自动重连，但某些错误需要特殊处理。
-
数据格式：虽然SSE支持直接发送文本，但建议使用JSON格式传输复杂数据。
5. SSE与WebSocket的对比
很多开发者会纠结该用SSE还是WebSocket。根据我的经验，选择取决于具体需求：
| 特性 | SSE | WebSocket |
|---|---|---|
| 协议 | HTTP | 独立协议 |
| 方向 | 单向(服务器→客户端) | 双向 |
| 连接 | 简单HTTP连接 | 需要协议升级 |
| 重连 | 自动处理 | 需要手动实现 |
| 数据格式 | 文本 | 二进制或文本 |
| 浏览器支持 | 除IE外主流浏览器 | 所有现代浏览器 |
提示：如果你的应用只需要服务器向客户端推送数据，SSE通常是更好的选择，因为它更简单、更轻量。
6. 生产环境中的SSE实践
在实际生产环境中使用SSE，有几个重要的注意事项：
6.1 连接管理
SSE连接是长连接，会占用服务器资源。在高并发场景下，需要注意：
- 设置合理的超时时间
- 实现连接数限制
- 使用连接池管理资源
6.2 错误处理
完善的错误处理机制非常重要：
java复制emitter.onError((ex) -> {
log.error("SSE error", ex);
// 清理资源
});
6.3 性能优化
对于高频率数据推送，可以考虑以下优化：
- 批量发送数据
- 压缩数据
- 使用专门的服务器处理SSE连接
7. 常见问题与解决方案
在SSE实践中，我遇到过不少问题，这里分享几个典型问题及其解决方案：
7.1 连接断开问题
现象：客户端频繁断开重连。
原因：通常是网络不稳定或服务器处理时间过长。
解决方案：
- 调整重试时间
- 实现心跳机制保持连接活跃
- 优化服务器处理逻辑
7.2 内存泄漏问题
现象：随着时间推移，服务器内存不断增长。
原因：未正确关闭完成的SseEmitter实例。
解决方案：
- 确保在所有情况下（完成、错误、超时）都清理资源
- 使用WeakReference存储Emitter引用
- 定期检查并清理闲置连接
7.3 跨域问题
现象：前端无法连接到SSE端点。
解决方案：
java复制@CrossOrigin(origins = "*")
@GetMapping("/stream")
public SseEmitter stream() {
// ...
}
或者全局配置CORS：
java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**").allowedOrigins("*");
}
}
8. 高级用法：Spring Security集成
在需要认证的场景下，SSE端点也需要保护。Spring Security可以与SSE完美配合。
8.1 基本安全配置
java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http
.authorizeRequests()
.antMatchers("/api/sse/**").authenticated()
.and()
.httpBasic();
}
}
8.2 带认证的SSE客户端
客户端需要提供认证信息：
javascript复制const eventSource = new EventSource('/api/sse/temperature', {
withCredentials: true
});
或者在URL中包含token：
javascript复制const eventSource = new EventSource('/api/sse/temperature?token=xxx');
9. 测试SSE端点
测试SSE端点与测试普通REST端点有些不同。这里分享几种测试方法：
9.1 使用curl测试
bash复制curl -N http://localhost:8080/api/sse/temperature
9.2 使用Postman测试
Postman支持SSE测试，在发送请求时选择"SSE"选项即可。
9.3 单元测试
java复制@Test
public void testSseEndpoint() throws Exception {
MockHttpServletRequestBuilder request = get("/api/sse/temperature");
MvcResult result = mockMvc.perform(request)
.andExpect(request().asyncStarted())
.andReturn();
SseEmitter emitter = (SseEmitter) result.getAsyncResult();
// 验证emitter行为
}
10. 性能监控与调优
对于生产环境的SSE应用，性能监控非常重要。以下是一些关键指标：
- 连接数：当前活跃的SSE连接数量
- 消息速率：每秒发送的消息数量
- 延迟：从数据产生到客户端接收的时间
- 错误率：连接错误的比例
可以使用Spring Actuator或自定义端点暴露这些指标：
java复制@Endpoint(id = "sse-metrics")
@Component
public class SseMetricsEndpoint {
@ReadOperation
public Map<String, Object> metrics() {
// 返回监控数据
}
}
11. 实际案例：实时日志系统
让我分享一个真实的SSE应用案例 - 实时日志系统。这个系统需要将服务器日志实时推送到管理后台。
11.1 系统架构
- 日志收集器收集各服务日志
- 日志处理器过滤和格式化日志
- SSE服务端将日志推送到前端
11.2 关键实现
java复制@GetMapping("/logs")
public SseEmitter streamLogs(@RequestParam String level) {
SseEmitter emitter = new SseEmitter();
LogAppender appender = new LogAppender() {
@Override
public void append(LogEvent event) {
if (event.getLevel().isMoreSpecificThan(Level.toLevel(level))) {
try {
emitter.send(SseEmitter.event()
.data(event.getMessage().getFormattedMessage())
.name("log"));
} catch (IOException e) {
// 处理错误
}
}
}
};
LoggerContext.getContext().getRootLogger().addAppender(appender);
emitter.onCompletion(() -> {
LoggerContext.getContext().getRootLogger().removeAppender(appender);
});
return emitter;
}
这个实现的关键点在于：
- 动态添加Log4j Appender
- 根据日志级别过滤消息
- 在连接关闭时清理资源
12. 扩展思考：SSE的替代方案
虽然SSE在很多场景下表现良好，但也有一些替代方案值得考虑：
12.1 长轮询
传统的长轮询技术也可以实现类似效果，但效率较低。
12.2 WebSocket
如前所述，WebSocket适合需要双向通信的场景。
12.3 GraphQL订阅
GraphQL的订阅功能提供了更结构化的实时数据推送方案。
12.4 RSocket
RSocket是一种新的反应式网络协议，支持多种交互模式。
在实际项目中，我通常会根据具体需求选择最合适的技术。SSE因其简单性和HTTP兼容性，在很多场景下仍然是首选。
13. 最佳实践总结
根据我在多个项目中使用SSE的经验，总结以下最佳实践：
- 合理设置超时：根据业务需求设置合适的超时时间
- 完善的错误处理：处理所有可能的错误情况
- 资源清理：确保连接关闭时释放所有资源
- 安全考虑：对敏感数据实施适当的认证和授权
- 性能监控：建立全面的监控系统
- 优雅降级：在不支持SSE的环境提供备选方案
14. 未来展望
随着实时Web应用的需求不断增长，SSE技术也在不断发展。一些值得关注的趋势：
- 协议增强：可能支持二进制数据传输
- 更好的浏览器支持：更一致的跨浏览器行为
- 与HTTP/3集成：利用HTTP/3的多路复用特性
无论技术如何发展，理解SSE的基本原理和最佳实践都是非常有价值的。