perf(realtime): 一次广播只序列化一次,不再按订阅者重复 stringify

抓包发现单个后台客户端 5 秒收到 981,776 字节 / 336 条事件(约 196KB/s、67 条/秒、
每条平均 2680 字节,最大 6418 字节)。事件构成:work_order.changed 34 条/秒、
order.changed 23 条/秒、admin_notification.changed 7.6 条/秒。

原广播实现在订阅者循环里逐个 `JSON.stringify(payload)` 并重建 SSE 模板串:
客户端越多,同一份载荷就被序列化越多次(后台/打手端都在线时更明显)。
改成先 `buildEventFrame()` 构造一次,循环里只写同一帧:

- broadcast() 只调用一次 buildEventFrame
- writeEvent()(ready 事件与断线补发)复用同一构造函数
- 行为不变,仅去掉重复序列化

受众过滤经核对本来就是正确的(admin 事件只发后台、worker 事件按 workerIds 过滤),
realtime_events 也有自我清理(每 100 条保留最近 500 条,实测 555 行/2MB),
故本次只动序列化这一处。

验证:后端 548 项单测全绿(新增 1 项守卫,禁止 broadcast 内再出现 JSON.stringify)。
This commit is contained in:
yml2213
2026-10-01 15:46:43 +08:00
parent 1f8252a6bc
commit 142c4ee141
2 changed files with 43 additions and 7 deletions
@@ -471,24 +471,37 @@ function isEventVisibleToSubscriber(event: StoredRealtimeEvent, subscriber: Real
}
function broadcast(subscribers: Iterable<RealtimeSubscriber>, event: RealtimeEvent) {
// 同一份载荷要发给 N 个订阅者,序列化必须只做一次。
// 生产实测单个后台客户端就能收到约 67 条/秒、每条约 2.7KB 的事件,
// 原实现在订阅者循环里各写一次 JSON.stringify + 模板串,客户端越多越吃亏。
const frame = buildEventFrame('realtime', event)
for (const subscriber of subscribers) {
writeEvent(subscriber, 'realtime', event)
writeEventFrame(subscriber, frame)
}
}
/** 预先构造一整帧 SSE 报文(含 `id:` 行),供广播复用。 */
function buildEventFrame(name: string, payload: unknown): string {
const eventId =
name === 'realtime' && payload && typeof payload === 'object' && 'eventId' in payload
? Number((payload as { eventId?: unknown }).eventId || 0)
: 0
const idLine = eventId > 0 ? `id: ${eventId}\n` : ''
return `${idLine}event: ${name}\ndata: ${JSON.stringify(payload)}\n\n`
}
function writeEvent(subscriber: RealtimeSubscriber, name: string, payload: unknown) {
writeEventFrame(subscriber, buildEventFrame(name, payload))
}
function writeEventFrame(subscriber: RealtimeSubscriber, frame: string) {
if (subscriber.response.writableEnded || subscriber.response.destroyed) {
removeSubscriber(subscriber)
return
}
try {
const eventId =
name === 'realtime' && payload && typeof payload === 'object' && 'eventId' in payload
? Number((payload as { eventId?: unknown }).eventId || 0)
: 0
const idLine = eventId > 0 ? `id: ${eventId}\n` : ''
subscriber.response.write(`${idLine}event: ${name}\ndata: ${JSON.stringify(payload)}\n\n`)
subscriber.response.write(frame)
} catch {
removeSubscriber(subscriber)
}