计算机网络 / 系统课时

用日志串起一次异常连接

用日志串起一次异常连接

线上 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 事件。它可以直接作为线上日志导出后的最小排查工具。

js
// 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")}`
);

预期输出

text
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,再按时间恢复生命周期。不要先按错误级别搜全局日志,因为同一根因常常会制造大量次生错误。

  1. 确认是否存在 open。没有则问题仍在 HTTP 升级、代理或网络阶段。
  2. 检查鉴权结果。若 open 后立即出现 auth_fail,优先核对令牌、时间有效期和身份绑定。
  3. 查看订阅与业务请求。用 requestId 检查请求是否有对应响应或确认。
  4. 检查最后一次心跳时间,再看 closeCode、reason 和服务端主动关闭记录。
  5. 若设备频繁重连,再用 deviceId 横向查询多个 connectionId,判断是单连接故障还是设备级网络抖动。

避免关联日志失真

最常见的问题是标识复用。connectionId 不能跨重连复用,否则两个生命周期会被错误拼接;requestId 在并发请求下也必须唯一,否则确认消息会匹配到错误请求。设备更换登录身份时,日志中的 deviceId 也要随着绑定关系更新。

另一个常见问题是只记录错误而不记录正常状态迁移。没有 auth_ok、subscribe、command_ack 这些成功事件,就无法判断连接究竟走到了哪一步。真正有用的日志链应能同时证明“发生了什么”和“没有发生什么”,从而把异常缩小到明确的生命周期节点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用日志串起一次异常连接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通