一、这一篇在处理什么
这一篇只处理一件事：在香港运行的直播互动，使用维科云的SDK 盾时，如何处理「日志里没有节点和版本」。
用户说连不上，日志里只有「失败」。没有 SDK 版本、节点和错误码，无法判断是客户端、隧道还是源站。
看失败日志里版本、节点、错误码三个字段是否齐全。
二、香港的网络和高峰
交易和晚间活动重叠时最忙，白天也有稳定流量。到华南和东南亚都近，常被当成回源点。回源集中在香港时，香港出口会先满。
排查时：分开看「用户到香港」和「香港到源站」。前一段慢是调度问题，后一段慢是回源问题。
不要这样做：所有地区都回源到香港。离香港远的用户会在回源这一段变慢。
三、直播互动要分开的路径
推流、播放和聊天是三条路径。播放地址用短时令牌，聊天不要走播放的缓存。
防护边界：播放令牌过期应在场次中途之前刷新。不要把直播切片和网页跳转规则混在同一个域名上。
验证：看首帧时间、卡顿来自主播上行还是观众分发，以及结束后直播地址是否停止、回放是否另给地址。
四、SDK 盾怎么接
App 里的登录、下单等关键请求走 SDK 隧道，图片和安装包仍走 CDN。服务端校验时间窗、随机数和签名，不把源站地址写进客户端包。隧道失败时可以降级，但降级必须打点，不能静默改去连源站 IP。
产品说明见SDK 盾。只改和「日志里没有节点和版本」有关的域名或路径，不要把直播互动的其他路径一起改掉。
五、排查步骤
下面五步按因果顺序执行，后一步依赖前一步的结果。步骤针对「日志里没有节点和版本」，不是一套通用清单。
- 推流、播放和聊天分开统计。播放地址的令牌过期要单独计数。 把「用户到香港」和「香港到源站」分成两段计时。 这一故障在本步要完成的事：规定失败日志至少包含版本、节点、错误码和请求 ID。
- 聊天不要走播放缓存。播放令牌在场次结束前刷新，不要等观众已经 403。 前一段慢就处理调度，后一段慢就处理回源。不要两段用同一个动作。 这一故障在本步要完成的事：核对现有版本是否在失败分支提前返回，把日志跳过了。
- 播放切片和网页跳转不要共用一个域名。需要拦截时只拦被盗用的播放域名。 其他地区若都回源到香港，先把远地区的回源移走，避免香港出口被挤满。 这一故障在本步要完成的事：请求 ID 从客户端传到服务端。
- 转码和录制不要和播放写在同一块磁盘或同一条队列里。 回源调整完成前，不要用重启香港源站来掩盖排队。 这一故障在本步要完成的事：用一次失败请求把四段日志对齐。
- 测量首帧，并判断卡顿来自主播上行还是观众分发。结束后直播地址应停止，回放另给地址。 分别从香港本地和另一个远地区复测这两段时间。 这一故障在本步要完成的事：缺字段的版本不允许再发布。
六、处理办法
- 错误码表写进文档。
- 日志不要打印密钥和完整令牌。
- 客服按请求 ID 查询。
改完后在香港的用户网络上复查，不要只在机房内网看。复查时带上直播互动的验证：看首帧时间、卡顿来自主播上行还是观众分发，以及结束后直播地址是否停止、回放是否另给地址。
七、案例
投诉无法复现。旧版本在超时分支没有打节点号。补上之后，同一请求 ID 能在边缘和服务端对上。
若同样的现象出现在香港，额外核对：分开看「用户到香港」和「香港到源站」。前一段慢是调度问题，后一段慢是回源问题。
业务侧核对：推流、播放和聊天是三条路径。播放地址用短时令牌，聊天不要走播放的缓存。
这个案例只说明怎么定位，不构成容量或可用性承诺。
八、常见问题
问：日志太多怎么办？
答：成功请求抽样，失败请求全量，但仍然不能带密钥。
问：节点号从哪里来？
答：隧道握手成功时由调度返回。握手前的失败要记下调度地址。
问：用户不提供时间怎么办？
答：用请求 ID，不依赖用户回忆的分钟数。
问：同一故障换一个地区或一种业务，排查还一样吗？
答：不一样。每一步都先按直播互动的路径处理，再按香港的网络条件收窄，最后才做「日志里没有节点和版本」这一故障本身的动作。换地区或换业务，前两段操作就会变。
九、边界
只讨论SDK 盾在「日志里没有节点和版本」上的处理，地区范围是香港，业务范围是直播互动。请遵守当地法律。维科云提供网络能力，不对客户业务内容负责。