苹果CMS采集失败的表现无非几类：任务卡住不动、中途报错退出、采回来是空数据。把后台提示的报错归到对应的类别里，排查方向立刻清晰。本文按出现频率整理了五类常见报错，遇到问题先对号入座。
连接超时
现象是任务长时间无响应后报超时。常见原因有三个：接口服务器慢或已经半死、本机出网带宽被采集任务占满、超时参数设得过短。先在浏览器里直接打开接口地址验证对方死活，对方活着就检查服务器网络与超时配置，接口彻底失联的按失效流程换源，并用多采集源轮询策略兜底。排查时可以在服务器上用命令行直接请求接口地址，与浏览器结果对比，能区分是对方慢还是本机网络问题；超时参数要与接口的日常响应时间匹配，平时一秒返回的接口，没必要留三十秒的超时。
403 与请求被拒
接口返回 403 说明对方拒绝了请求，多半是采集频率过高触发了资源站的防护。降低频率、错开高峰是第一步，可以把定时任务挪到凌晨执行，做法参考苹果CMS定时采集教程；如果整站被拉黑，联系对方或直接换源。这类攻防的完整视角在采集接口安全防护一文里有展开。降频不是把任务改成一天一次就完事，重点是控制单次请求的节奏与并发量，批次减小、间隔拉开，多数 403 会自然消失；同时留意自己的出口 IP 是否已被对方拉黑，换 IP 之后依旧高频请求没有意义。
返回 HTML 而非数据
采集程序期待 JSON，收到的却是网页，通常是三种情况：接口域名已被停放、域名跳转到了官网首页、对方开启了人机验证。判断方法很简单，看返回内容的开头，以 HTML 标签开头的基本可以宣告该接口失效，直接进入换源流程。
JSON 解析失败
返回内容既不是网页也不是合法 JSON，多数是响应被截断或编码异常。先确认采集配置里的输出格式选项与接口实际支持的一致，再看响应是否完整；想读懂原始返回的结构，可以参考资源采集原理科普里的数据链路说明。还有一种隐蔽情况是响应里混入了调试信息或告警文本，破坏了 JSON 的完整性，把返回内容存成文件看一眼结尾，往往一眼就能定位。
写库失败
报错发生在数据已经采到之后，常见原因是数据库连接数打满、磁盘空间不足或字段长度超限。检查数据库状态和磁盘余量，数据量大的站点分批采集能明显缓解。长期靠人工救火不是办法，监控看板可以把这类异常提前暴露出来。采集与前台访问共用数据库时，采集任务很容易把连接额度吃光，先表现为前台报错，这类问题要检查数据库的连接数上限设置。