采集排障手册

症状 → 原因 → 处理

采回来的文件是空的

先看登录态。 九成的空文件是会话失效：接口返回了登录页 HTML，解析自然拿不到数据。重新登录后再采一次。

数据缺日期

日期控件没生效。京准通的日期是双开关，需要先重置再设置；商智要改用请求体改写方式。

采到一半停了

网络抖动或页面超时。任务支持断点续跑，从中断的 SKU / 页码继续，不必从头再来。

被限制访问

降低频率，拉大请求间隔。不要并发打同一个站点。

同一个词两次结果不一样

排名有千人千面因素。同一环境、同一时间连续采两次，差异应在一两位以内；差异过大说明环境不干净（有其他脚本或扩展在跑）。

排障顺序

登录态有效？
  → 否：重新登录
  → 是：页面能打开？
       → 否：检查网络与目标站点状态
       → 是：日期 / 筛选生效？
            → 否：检查控件状态
            → 是：解析选择器匹配当前组件库？
                 → 否：更换选择器
                 → 是：落盘路径可写？