SSE 转 JSON
格式化后的 JSON 将显示在这里
在左侧粘贴以空行分隔的 id/event/data 数据块,每个事件会成为 JSON 数组中的一项
专为 Server-Sent Events(SSE)推流数据打造的转换工具。在左侧粘贴原始 id/event/data 数据块,右侧即时渲染为标准 JSON 数组,每条推送事件成为一个对象,包含其 id、事件名以及解析后的 data 数据体。
相关推荐
什么是 SSE 转 JSON?
Server-Sent Events(SSE)是一种单向流式协议:服务器在内容类型为 text/event-stream 的 HTTP 响应里持续写入 UTF-8 文本事件。在线格式上,每个事件都是若干字段行,例如 id: 1、event: MESSAGE、data: {...},并用一个空行表示该事件结束。
原始 SSE 便于传输却不便于阅读和调试:每个事件都重复字段名、JSON 数据体藏在 data: 前缀后面,长事件流更是挤成一片文本。把 SSE 转成 JSON,就是把每个事件规整为一个普通对象,再把所有事件收集进一个 JSON 数组。
本转换器遵循事件流解析规则:按换行切分、把空行作为派发边界、只去掉字段冒号后的一个可选空格、用换行拼接重复的 data 行、忽略以冒号开头的注释,然后把每个 data 数据体解析为 JSON,保留嵌套结构。
最终得到一个标准的、带缩进的 JSON 数组,便于阅读、复制到代码、与另一次抓包做对比或交给下游工具;任何无法解析的数据体都会被明确标记,而不是被丢弃。
适用场景
- 调试以 SSE 事件块推送的大模型或 AI Agent 流式响应,例如 STREAM_CHUNK、CHUNK_DELTA
- 把浏览器开发者工具 Network 面板里复制的 text/event-stream 响应转成可读 JSON
- 查看实时推送或聊天后端的心跳、ack 以及完整消息事件
- 把抓到的 SSE 推流转成 JSON 数组后再发给同事协同排查
- 无需手工删除 data: 前缀即可展开每个事件里嵌套的 data 数据体
- 离线回放录制的推送流,并按 id 对比事件先后顺序
- 把 SSE 事件数据整理成期望 JSON 数组的分析、日志或表格流程
- 前后端联调时验证服务端是否按预期推送事件名和数据结构
- 把多行 data 字段归并为每个事件对象中的一个解析值
- 以结构化、便于折叠的方式查看来自代理、网关或 curl 输出的 SSE 报文
- 把复用 SSE 线格式的 Webhook 或消息队列事件流转成 JSON
- 通过观察 id、event、data 如何映射为 JSON 对象来学习 Server-Sent Events 线格式
使用方法
- 把原始 SSE 流粘贴到左侧文本框,事件之间用空行分隔,每行形如 id/event/data
- 右侧会自动更新,展示每个事件对应一个对象的 JSON 数组
- 若某个 data 不是合法 JSON 或字段异常,请查看告警提示
- 用“复制”拷贝整个 JSON 数组,也可先点“示例”加载内置样例
功能特点
- 把原始 SSE 事件流转换成标准 JSON 数组,每条推送事件对应一个对象
- 按空行对事件分块,遵循 Server-Sent Events 的事件派发模型
- 按“字段: 值”解析每一行,并自动去掉冒号后的一个空格
- 用 JSON.parse 解析每个 data 数据体,让嵌套载荷成为真正的对象而不是转义字符串
- 字段顺序固定为 id、event、data,纯数字 id 会转成 JSON 数字
- 支持多行 data 字段、以冒号开头的注释行,以及末尾没有空行的事件流
- 对无法解析的 data、未知或格式错误的字段给出所在块与行号告警
- 左 textarea 输入、右 JSON 预览的分栏布局,带示例、清空、复制与事件统计,全程浏览器本地运行
SSE 转 JSON vs JSONL 格式化 vs JSON 格式化
这几个工具处理的输入形态不同,选对工具可以省去手工去前缀、包数组的麻烦。
| 工具 | 输入形态 | 核心能力 | 适用场景 |
|---|---|---|---|
| SSE 转 JSON | 以空行分隔的 id/event/data 数据块 | 识别 SSE 字段并解析每个 data 数据体 | 服务端推送流、text/event-stream、AI 流式分块 |
| JSONL 格式化 | 每行一个完整 JSON 对象 | 逐行独立校验与格式化 | NDJSON 日志、事件归档、按行分隔的导出 |
| JSON 格式化 | 单个完整 JSON 对象或数组 | 美化一整份完整 JSON 文档 | 接口响应、配置文件、一次性数据体 |
最佳实践
复制事件流时保留事件之间的空行
空行是区分相邻 SSE 事件的边界。如果复制时把空行删掉,不同事件会被合并成一个块,转换结果也就无法对应原始的派发顺序。
借助告警里的块号、行号快速定位问题
当某个 data 解析失败时,告警会指出是第几个事件块、哪一行。把它和附近一个正常事件对比,通常就能发现括号被截断、少了引号或分块被拼接的问题。
记住只有 data 字段会被当作 JSON 解析
id、event、retry 都是 SSE 传输层元信息,会保留为标量值。不要指望工具去解析 event 名或 id 里的 JSON,结构化内容应放在 data 中。
拼合完整消息前先转换整段流式分块
许多 AI 流会用大量细小的 STREAM_CHUNK 事件拼出一条消息。可以先转换整段抓包,把每个分块看成数组中的一项;需要最终消息时,再在业务代码里合并这些分块数据体。
外发转换后的 JSON 前先脱敏
转换虽然在本地完成,但一旦把 JSON 数组复制到工单或聊天里就离开了你的机器。分享前请移除令牌、用户 ID 和私密会话内容。
常见问题
什么是 SSE(Server-Sent Events)?
SSE 是服务器通过 HTTP 以 text/event-stream 内容类型向浏览器单向推送文本事件的标准方式。每个事件由 id、event、data 等文本行组成,事件与事件之间用一个空行分隔。
这个工具如何把事件流切分成一个个事件?
它遵循 SSE 的派发模型:先按行切分,连续的非空行组成一个事件块,遇到空行就把该块派发为一个新事件;即使最后一个事件块后面没有空行也会输出,以冒号开头的注释行会被忽略。
输出的 JSON 长什么样?
输出是一个 JSON 数组,每个输入事件对应一个对象,只包含实际出现过的字段,且字段顺序固定为 id、event、data。其中 data 文本会用 JSON.parse 解析,因此 data: {"a":1} 会变成嵌套对象 "data": {"a":1},而不是被转义的字符串。
为什么输出里的 id 是数字?
SSE 的 id 在协议层面是字符串,但真实推送流几乎都用 id: 0 这样的数字编号。当 id 只由数字组成时,本工具会把它输出为 JSON 数字,其余情况则保留为字符串。
data 跨越多行时怎么处理?
按照 SSE 规范,同一事件里的多行 data: 会先用换行符拼接成一个值再解析。如果拼接后的文本不是合法 JSON,工具会保留原始文本并给出告警,不会悄悄丢数据。
如果某个 data 不是合法 JSON 会怎样?
不会让整次转换失败:该事件会把原始 data 保留为 JSON 字符串,页面同时给出带块号和解析错误信息的告警,其前后的合法事件依然正常转换。
SSE 转 JSON 和 JSONL 格式化有什么区别?
JSONL 是每一行就是一个完整 JSON 对象;而 SSE 是带 id/event/data 标签的多行、并以空行给事件分组,且只有 data 部分是 JSON。SSE 转 JSON 能识别这些字段标签和空行事件边界,JSONL 格式化则会把每一行都独立处理。
转换会上传我的推流数据吗?
不会。解析与格式化全程在浏览器本地完成,推送数据、令牌、会话内容都不会发送到服务器。
术语表
- SSE
- Server-Sent Events,服务器通过 HTTP 向客户端单向推送事件流的标准协议。
- text/event-stream
- SSE 响应体的 MIME 媒体类型,内容由字段行组成,事件之间用空行分隔。
- 事件块
- 一组连续的非空字段行,共同描述一条推送事件,以空行结束。
- data 字段
- 承载事件数据体的 SSE 字段;同一事件内的多行 data 会用换行拼接,通常是 JSON。
- event 字段
- 可选字段,用于指定事件类型;缺失时浏览器会按通用的 message 事件派发。
- id 字段
- 可选的“最后事件 ID”,用于断线续传;本工具会把纯数字 id 输出为 JSON 数字。
- retry 字段
- 可选字段,告诉客户端断线重连的等待毫秒数,值只能由 ASCII 数字组成。
- 注释行
- 以冒号开头的行,常用作心跳或保活,在构建事件时会被忽略。
Authoritative References
- MDN Web DocsMDN:Server-sent events(服务器发送事件)
- HTML Living StandardWHATWG:Server-sent events 事件流格式规范
- JSON 压缩
- CSV 转 JSON
- JSON 转 CSV
- JSON Diff
- JSON Escape / Unescape
- JSON扁平化
- JSON 格式化
- JSONL 格式化
- SSE 转 JSON
- JSON 生成器
- JSONPath 查询
- JSON 合并
- JSON 修复
- JSON Schema 校验
- JSON 排序
- JSON Stringify
- JSON 转 HTML
- JSON 转 Java
- JSON 转 Markdown
- JSON 转 SQL
- JSON 转 TOML
- JSON 转 TypeScript
- XML 转 JSON
- JSON 转 XML
- YAML 转 JSON
- JSON 转 YAML
- JSON 转 Python
- JSON 转 Go
- JSON 转 Rust
- JSON 转 Swift
- JSON 转 C#
- JSON 转 C++
- JSON 转 PHP