干得好好的采集任务某天突然采不到东西，八成是接口失效了。处理思路是固定的：先确认是接口死了还是自己配置动了，再决定换域名还是换源，最后把分类和数据收尾干净。照着本文的顺序做，一般半小时内能恢复更新。
先确认失效的典型现象
常见表现有三种：后台试采返回空列表；采集任务报连接超时；能采到列表但详情全部失败。三种现象对应的病根不同：第一种多半是接口数据结构变了或源停服；第二种可能是源站限制了访问；第三种常见于源站正在迁移、列表和详情不同步。不要上来就删接口，先花两分钟看现象属于哪种，再对症处理，否则删了配置又得从头添加。
第一步：判断接口死活
最直接的办法是把接口地址粘到浏览器里打开：返回标准 json 或 xml 数据说明接口还活着，问题在程序侧；返回网页、停放页或直接打不开，基本可以判定接口死亡。在服务器上用命令行再测一遍更保险，可以排除本机网络环境的干扰。详细的死活判断方法见资源采集原理科普中的相关章节。
第二步：换源与分类重绑
接口确认死亡后，从影视资源采集站大全里挑一个内容类型相近的替代源，比如综合类的樱花资源、量子资源。新源添加后重点做分类重绑：不同源的分类 ID 不一样，直接沿用旧映射会采错分类。重绑完成先试采再全量，不要跳过验证环节。换源时还有一点要注意：新旧源对同一部影片的命名可能不一致，入库后会出现同片两条记录，需要按名称加年份核对合并。
第三步：收尾与数据清理
旧源留下的失效播放地址不会自动消失，建议按源筛选旧数据做下线或删除处理，避免用户点开全是坏链。如果站点开启了多源容错，把死源从轮询池里摘除，配置思路见多采集源轮询策略。清理动作完成后记一笔档案：失效时间、现象、替换源，积累多了就能看出哪些源群经常整体出问题。
预防：让下次失效不伤筋动骨
长期策略有三条：主力源始终保留备胎；用监控看板盯采集任务的失败率，失效当天就能发现；定期备份数据库。做完这三件事，接口失效从事故变成日常维护的一部分。失效不可怕，可怕的是失效了半个月才发现、发现后没有备源可用。