SSE 在线调试

连接 Server-Sent Events 事件流,实时查看每个事件的类型、id、数据和到达时间。支持带请求头和请求体的 POST 流式请求,适合调试大模型的 stream 接口,并能把增量内容拼接成完整文本;也可以粘贴原始 SSE 文本检查格式。

拼接后的文本

SSE 协议格式

event: message      ← 事件类型,省略时为 message
id: 42              ← 事件 id,断线重连时通过 Last-Event-ID 请求头发回服务器
retry: 3000         ← 建议的重连间隔(毫秒)
data: 第一行         ← 数据,可以有多行 data,会用换行拼接
data: 第二行
                    ← 空行表示一个事件结束
: 这是注释,常用作心跳
  • 响应头:服务器要返回 Content-Type: text/event-stream,并关闭缓冲:Nginx 加 proxy_buffering off; 或响应头 X-Accel-Buffering: no,否则事件会攒到一起才到达。也要注意 gzip 压缩会造成同样的问题。
  • EventSource 的限制:只能发 GET 请求,不能自定义请求头(无法带 Authorization),所以大模型接口通常用 fetch 读取流。EventSource 会自动重连,fetch 方式需要自己处理。
  • 跨域:浏览器直接请求其他域名的接口时,服务器需要返回 CORS 响应头;很多大模型 API 不允许浏览器直接调用,请用自己的后端转发,并且不要在网页中暴露密钥。
  • 连接数:HTTP/1.1 下同一域名最多 6 个连接,打开多个标签页的 SSE 会占满连接导致其他请求卡住;HTTP/2 没有这个问题。
  • 拼接文本:工具会识别 OpenAI 兼容格式(choices[0].delta.content)、Anthropic 格式(content_block_delta 的 delta.text)和纯文本 data,并忽略 [DONE] 结束标记。

调试 WebSocket 请用 WebSocket 在线测试,查看接口返回的 JSON 可以用 JSON 格式化校验,检查 HTTP 响应头可以用 HTTP 响应头查看。

SSE 在线调试常见问题

SSE 在线调试怎么使用?

在“EventSource”中填写事件流地址后点“连接”;需要 POST、请求头或请求体时切换到“流式请求”;也可以在“解析原始文本”中粘贴 SSE 文本检查格式。事件实时显示在下方,可以筛选和导出,大模型的增量内容会拼接显示在最下面。

SSE 和 WebSocket 有什么区别?

SSE 是服务器到浏览器的单向推送,基于普通 HTTP,自动重连;WebSocket 是双向通信。

怎么调试大模型的流式接口?

切换到“流式请求”,填写地址、Authorization 请求头和 stream 为 true 的请求体,即可看到每个增量事件。

EventSource 能带 token 吗?

不能自定义请求头,可以把 token 放在网址参数或 Cookie 中,或者改用 fetch 读取流。

为什么事件没有逐条到达?

服务器或反向代理有缓冲,需要关闭缓冲和压缩。

SSE 在线调试的结果应怎样理解?

浏览器直接请求时受跨域限制,服务器需要返回 CORS 响应头;EventSource 只能发送 GET 请求且不能自定义请求头;最多保留最近 5000 个事件。

输入内容会保存或发给外部服务吗?

请求由你的浏览器直接发送到目标地址,工具不经过任何服务器转发,也不保存填写的密钥。

没有结果或操作失败时先检查什么?

事件一次性全部到达时,是服务器或代理开启了缓冲或 gzip,Nginx 需要设置 proxy_buffering off;连接失败时检查 CORS 和 Content-Type 是否为 text/event-stream。

相关工具

GraphQL 调试器 · WebSocket 在线测试 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具