CDN故障定位

CDN 故障的棘手之处

当用户反馈"视频卡顿"或"页面打不开"时，问题可能出在 CDN 节点、回源链路或源站本身。传统排查方式往往要登录多台服务器、翻看分散的日志、手动构造请求，整个过程耗时且容易遗漏关键线索。尤其是在高并发场景下，一个配置错误可能导致大面积缓存击穿，而排查窗口期往往只有几分钟。

这个技能如何工作

该技能将 CDN 故障排查标准化为可执行的流程，核心能力包括：

拨测与链路识别

• 通过 curl 命令直接向源站发起请求，快速区分问题是 CDN 侧还是源站侧
• 解析响应头中的 Via 字段，识别请求经过的节点层级（如 SN10-SNS-215-CMXA-CMG 表示 L1 边缘节点）
• 检查 Cache-Control: max-age 和 Age 头，判断缓存新鲜度与命中状态

常见故障分类排查
针对七类典型故障提供结构化的排查路径：

• 命中率低：检查 Cache-Control/Expires/Vary 配置是否导致缓存碎片化
• 502 Bad Gateway：排查上游 ATS/源站可用性、协议匹配与 SNI/证书问题
• 504 Gateway Timeout：分析上游响应超时、源站性能或网络延迟
• 内容不刷新：验证失效操作是否生效、Vary 是否导致多副本未失效

日志与责任界定

• 统一访问 Nginx 与 ATS 的实时及归档日志路径
• 根据故障特征（如 Via 头异常、5xx 比例、命中率）快速划分 CDN 侧/源站侧/客户端责任

适用边界与注意点

该技能聚焦于故障定位与责任界定，不负责配置自动修复。日志路径和配置文件位置基于特定部署环境（如 /home/node/.openclaw/），实际使用时需根据现场路径调整。源站拨测需要准确的 Host 头信息，通常应使用原始域名而非源站地址本身。对于架构层面的容量规划或性能优化问题，仍需结合监控数据与架构文档单独分析。