spring web 的 serversentevent 默认不支持纯空行 ping 事件，但可通过构造特殊空评论（comment）的方式生成符合规范的 :\n\n 心跳帧，实现 graphql sse 协议要求的连接保活。
spring web 的 serversentevent 默认不支持纯空行 ping 事件，但可通过构造特殊空评论（comment）的方式生成符合规范的 :\n\n 心跳帧，实现 graphql sse 协议要求的连接保活。
在基于 Server-Sent Events（SSE）构建实时流式 API（如 GraphQL over SSE）时，客户端与服务端需维持长连接，并通过周期性心跳（ping）检测连接活性。根据 GraphQL SSE 规范，心跳必须以纯注释行形式发送：:\n\n（即冒号后跟两个换行符），且不能包含 event:、data: 或 id: 等字段——这恰好避开了标准 ServerSentEvent 对非空 data 或显式 type 的约束。
Spring Framework 并未提供直接的 .ping() 方法，但其底层 ServerSentEventHttpMessageWriter 在序列化时遵循 SSE 标准：当仅设置 comment 字段（且值为空字符串）时，会输出 : + \n；若其他字段（data, event, id, retry）均未设置，则自动追加一个 \n，最终形成合规的 :\n\n。
✅ 正确实现方式（Java）：
ServerSentEvent<void> pingEvent = ServerSentEvent.builder("")
.data(null) // 显式设为 null，避免默认空字符串干扰
.comment("") // 关键：空评论触发 ":" + "\n"
.build(); // 无其他字段 → 自动补第二个 "\n"</void>
✅ Kotlin 写法更简洁（利用泛型推导）：
val pingEvent = ServerSentEvent.builder<string>()
.comment("")
.build()</string>
⚠️ 注意事项：
- 不可省略 .builder("") 中的空字符串参数：它是 type 字段的占位符（即使为空），否则编译失败（Java 泛型擦除导致类型推导失效）；
- 禁止设置 data("") 或 data(" ")：这将触发 data: \n 行，破坏 ping 格式；
- 不要依赖 ServerSentEvent.EMPTY：它生成的是空响应体，不输出任何内容，无法触发心跳；
- 实际使用中，建议配合 Flux.interval() 定期发送（例如每 15 秒一次），并确保 SseEmitter 未关闭：
Flux.interval(Duration.ofSeconds(15)) .map(tick -> pingEvent) .subscribe(emitter::send);
总结：Spring Web 虽未显式暴露 ping 接口，但通过精准控制 ServerSentEvent 的构造参数（空 type + 空 comment + 全部其他字段留空），即可严格遵循 SSE 规范生成心跳帧，为 GraphQL SSE 等协议提供可靠连接保活能力。
