常见问题（Troubleshooting）

这里按「现象 → 可能原因 → 解决」来写，读者会最快定位问题。

现象：拉取失败 / 连接超时

• 可能原因
• sub2api 服务不可达（端口/反代/防火墙）
• ccswitch 运行环境无法访问 sub2api 的地址（网络隔离/DNS）
• 解决
• 记录一次失败请求的 URL、返回码、耗时
• 在 sub2api 所在机器本地访问一次确认服务状态

现象：转换成功但导入后不可用

• 可能原因
• 输出格式不匹配目标客户端
• 过滤/重写规则误伤关键节点
• 解决
• 固定一个最小订阅样本做对照（先不做过滤/重写）
• 对比“转换前/转换后”的节点数量与关键字段

现象：偶发成功/偶发失败

• 可能原因
• 上游订阅不稳定
• 定时任务并发触发，产物互相覆盖
• 解决
• 把更新触发改成串行，记录每次更新的时间戳与产物哈希（或大小）
• 先把上游订阅缓存到本地，再做转换（用于隔离变量）