计算机网络 / 系统课时
用日志串起一次异常连接
用日志串起一次异常连接
线上 WebSocket 异常最难查的往往不是“有没有报错”,而是同一条连接的握手、鉴权、订阅、消息、心跳和关闭日志散落在不同位置。本文用 connectionId 作为主线,再用 requestId 与 deviceId 补充关联,把一次异常连接还原成可验证的生命周期。
学习目标
- 设计能关联连接、请求与设备的结构化日志字段。
- 按连接生命周期还原异常发生前后的关键事件。
- 区分单次连接问题、单条请求问题和设备跨连接问题。
先确定三类关联标识
connectionId 应在 WebSocket 建立时由服务端生成,并一直绑定到这条物理连接;重连后必须生成新值。它最适合回答“这条连接从打开到关闭经历了什么”。
requestId 用于一次具体操作,例如升级请求、业务指令或确认消息。一个连接可以承载很多请求,因此它用于缩小范围,而不是替代 connectionId。deviceId 则代表业务设备身份,同一设备重连多次时仍保持不变,适合观察跨连接行为。
| 字段 | 生命周期 | 主要用途 |
|---|---|---|
connectionId |
一次 WebSocket 连接 | 串起打开、鉴权、消息、心跳、关闭 |
requestId |
一次请求或指令 | 匹配请求与响应、指令与确认 |
deviceId |
一个业务设备 | 观察重连、掉线和设备级异常 |
event |
单个日志事件 | 标记 open、auth_ok、heartbeat、command_ack、close 等阶段 |
closeCode / reason |
关闭时 | 记录关闭原因,避免只看到“连接断了” |

用结构化日志保留关键节点
日志应记录状态变化,而不是把每个数据包都无差别打印出来。至少覆盖连接打开、鉴权结果、订阅变更、关键业务消息、心跳超时与连接关闭;消息体只保留定位所需的摘要字段。
下面的脚本模拟读取一份 JSONL 日志,按 connectionId 过滤并按时间排序,同时检查是否存在 open、鉴权成功和 close 事件。它可以直接作为线上日志导出后的最小排查工具。
// trace-connection.mjs
const target = "conn-7f3a";
const lines = [
'{"ts":"2026-09-23T10:00:00.100Z","event":"open","connectionId":"conn-7f3a","requestId":"upgrade-91"}',
'{"ts":"2026-09-23T10:00:00.180Z","event":"auth_ok","connectionId":"conn-7f3a","deviceId":"dev-001"}',
'{"ts":"2026-09-23T10:00:01.020Z","event":"subscribe","connectionId":"conn-7f3a","deviceId":"dev-001"}',
'{"ts":"2026-09-23T10:00:05.200Z","event":"command","connectionId":"conn-7f3a","requestId":"req-42","deviceId":"dev-001"}',
'{"ts":"2026-09-23T10:00:05.310Z","event":"command_ack","connectionId":"conn-7f3a","requestId":"req-42","deviceId":"dev-001"}',
'{"ts":"2026-09-23T10:00:20.000Z","event":"heartbeat_timeout","connectionId":"conn-7f3a","deviceId":"dev-001","idleMs":15000}',
'{"ts":"2026-09-23T10:00:20.010Z","event":"close","connectionId":"conn-7f3a","deviceId":"dev-001","closeCode":4001,"reason":"heartbeat timeout"}'
];
const events = lines
.map((line) => JSON.parse(line))
.filter((item) => item.connectionId === target)
.sort((a, b) => a.ts.localeCompare(b.ts));
for (const item of events) {
const related = item.requestId ? ` requestId=${item.requestId}` : "";
console.log(`${item.ts} ${item.event}${related}`);
}
const names = new Set(events.map((item) => item.event));
console.log(
`lifecycle open=${names.has("open")} auth=${names.has("auth_ok")} close=${names.has("close")}`
);预期输出
2026-09-23T10:00:00.100Z open requestId=upgrade-91
2026-09-23T10:00:00.180Z auth_ok
2026-09-23T10:00:01.020Z subscribe
2026-09-23T10:00:05.200Z command requestId=req-42
2026-09-23T10:00:05.310Z command_ack requestId=req-42
2026-09-23T10:00:20.000Z heartbeat_timeout
2026-09-23T10:00:20.010Z close
lifecycle open=true auth=true close=true这里可以直接看出:指令 req-42 已收到确认,真正的异常发生在随后 15 秒无心跳,最后由服务端以 heartbeat timeout 主动关闭连接。若只搜索 requestId=req-42,会误以为这次交互完全正常;只有回到 connectionId 主线才能看到关闭原因。
按固定顺序定位异常
排查时先用异常告警、关闭日志或用户反馈找到一个 connectionId,再按时间恢复生命周期。不要先按错误级别搜全局日志,因为同一根因常常会制造大量次生错误。
- 确认是否存在
open。没有则问题仍在 HTTP 升级、代理或网络阶段。 - 检查鉴权结果。若
open后立即出现auth_fail,优先核对令牌、时间有效期和身份绑定。 - 查看订阅与业务请求。用
requestId检查请求是否有对应响应或确认。 - 检查最后一次心跳时间,再看
closeCode、reason和服务端主动关闭记录。 - 若设备频繁重连,再用
deviceId横向查询多个connectionId,判断是单连接故障还是设备级网络抖动。
避免关联日志失真
最常见的问题是标识复用。connectionId 不能跨重连复用,否则两个生命周期会被错误拼接;requestId 在并发请求下也必须唯一,否则确认消息会匹配到错误请求。设备更换登录身份时,日志中的 deviceId 也要随着绑定关系更新。
另一个常见问题是只记录错误而不记录正常状态迁移。没有 auth_ok、subscribe、command_ack 这些成功事件,就无法判断连接究竟走到了哪一步。真正有用的日志链应能同时证明“发生了什么”和“没有发生什么”,从而把异常缩小到明确的生命周期节点。