1. 为什么需要Server-Sent Events
在传统的Web应用中，客户端需要不断轮询服务器以获取最新数据，这种方式不仅效率低下，还会增加服务器负担。Server-Sent Events（SSE）提供了一种更优雅的解决方案，它允许服务器主动向客户端推送数据，特别适合需要实时更新的场景。
SSE与WebSocket不同，它是基于HTTP协议的单项通信机制。这意味着它不需要复杂的握手过程，实现起来更加简单。我在实际项目中发现，对于只需要服务器向客户端推送数据的场景（如股票行情、新闻推送、监控数据等），SSE往往是最合适的选择。
2. Spring Boot中实现SSE的基础配置
2.1 添加必要依赖
首先确保你的Spring Boot项目已经包含了Web依赖。在Maven项目中，pom.xml需要包含：
xml复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2.2 创建SSE控制器
创建一个简单的控制器来处理SSE连接：
java复制@RestController
@RequestMapping("/sse")
public class SseController {
@GetMapping(path = "/stream", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<String> streamEvents() {
return Flux.interval(Duration.ofSeconds(1))
.map(sequence -> "Event #" + sequence + " - " + LocalTime.now().toString());
}
}
这个简单的例子会每秒向客户端发送一个包含序列号和时间的事件。
3. 深入理解SSE的核心机制
3.1 事件流格式
SSE协议定义了一种简单的文本格式，每条消息由以下几部分组成：
- 事件类型（可选）
- 数据内容
- 标识符（可选）
- 重试时间（可选）
一个典型的事件流看起来像这样：
code复制event: status
data: {"user": "123", "status": "online"}
data: This is a simple message
3.2 连接管理
SSE连接默认是持久化的，但需要考虑以下几点：
- 连接中断后的自动重连机制
- 服务器端资源释放
- 心跳机制保持连接活跃
在Spring Boot中，我们可以利用Reactor的Flux来实现这些功能：
java复制@GetMapping("/advanced-stream")
public Flux<ServerSentEvent<String>> advancedStream() {
return Flux.interval(Duration.ofSeconds(1))
.map(sequence -> ServerSentEvent.<String>builder()
.id(String.valueOf(sequence))
.event("periodic-event")
.data("SSE - " + LocalTime.now().toString())
.build());
}
4. 客户端实现详解
4.1 基本JavaScript客户端
javascript复制const eventSource = new EventSource('/sse/stream');
eventSource.onmessage = (event) => {
console.log('New message:', event.data);
};
eventSource.onerror = (err) => {
console.error('EventSource failed:', err);
};
4.2 处理特定事件类型
如果你的服务器发送了不同类型的事件，可以这样处理：
javascript复制eventSource.addEventListener('status-update', (event) => {
const data = JSON.parse(event.data);
updateStatus(data);
});
5. 高级应用场景与优化
5.1 结合Spring Security
当需要保护SSE端点时，可以这样配置：
java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http
.authorizeRequests()
.antMatchers("/sse/**").authenticated()
.and()
.httpBasic();
}
}
5.2 性能优化技巧
- 连接池管理：对于大量并发连接，考虑使用Netty作为底层服务器
- 背压处理：合理配置Flux的缓冲策略
- 心跳机制：定期发送注释行保持连接活跃
java复制// 心跳示例
Flux<String> heartbeat = Flux.interval(Duration.ofSeconds(30))
.map(tick -> ":heartbeat\n\n");
6. 常见问题与解决方案
6.1 连接断开问题
症状：客户端频繁重连
解决方案：
- 检查服务器端超时设置
- 确保代理服务器（如Nginx）配置了适当的超时
nginx复制proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
6.2 内存泄漏
症状：随着时间推移，服务器内存持续增长
解决方案：
- 确保正确取消订阅Flux
- 使用
takeUntil等操作符限制流生命周期
java复制@GetMapping("/limited-stream")
public Flux<String> limitedStream() {
return Flux.interval(Duration.ofSeconds(1))
.take(10) // 只发送10条消息
.map(sequence -> "Event #" + sequence);
}
7. 实际项目中的应用建议
- 日志记录：为每个连接添加唯一标识符便于追踪
- 监控指标：暴露SSE连接数的metrics
- 优雅降级：当SSE不可用时提供轮询fallback
java复制@GetMapping("/events")
public Object getEvents(
@RequestHeader(value = "Accept", required = false) String acceptHeader) {
if (acceptHeader != null && acceptHeader.contains(MediaType.TEXT_EVENT_STREAM_VALUE)) {
// 返回SSE流
return sseStream();
} else {
// 返回普通JSON
return latestEvents();
}
}
8. 测试策略
8.1 服务器端测试
java复制@Test
public void testSseStream() {
webTestClient.get().uri("/sse/stream")
.exchange()
.expectStatus().isOk()
.expectHeader().contentType(MediaType.TEXT_EVENT_STREAM)
.expectBody(String.class)
.consumeWith(result -> {
assertTrue(result.getResponseBody().contains("Event #"));
});
}
8.2 客户端测试建议
- 使用Jest等框架模拟EventSource
- 测试各种网络中断场景
- 验证消息顺序和完整性
9. 与其他技术的比较
9.1 SSE vs WebSocket
| 特性 | SSE | WebSocket |
|---|---|---|
| 协议 | HTTP | 独立协议 |
| 方向 | 单向 | 双向 |
| 复杂度 | 低 | 中 |
| 重连 | 自动 | 需手动 |
| 数据格式 | 文本 | 任意 |
9.2 SSE vs 长轮询
SSE解决了长轮询的几个痛点：
- 减少不必要的HTTP请求
- 更低的延迟
- 更简单的服务器实现
10. 扩展应用场景
- 实时通知系统：用户在线状态、消息提醒
- 数据监控仪表盘：实时显示服务器指标
- 股票行情推送：实时价格更新
- 体育赛事直播：比分实时更新
- 物联网设备监控：传感器数据流
在实现一个物流跟踪系统时，我使用SSE来推送货物位置更新。相比之前的轮询方案，服务器负载降低了约70%，同时客户端的响应速度明显提升。关键是在Flux生成时加入了位置历史缓存，新连接的客户端能立即获取最近的10个位置点，实现了更好的用户体验。