域名切换与接口失效排查手册

源失效四类原因与排查路径。报修前先自己过一遍——能写清原因分类的报修帖，修复速度快一倍。

四类失效与特征

快速自查清单

text
接口超时/404        → 域名问题
字段缺失/结构变化    → 接口变更
401/403/风控页      → 鉴权升级
直连空/浏览器正常    → 反爬升级
只有部分书受影响     → 大概率是内容侧问题，不是源的问题

每类的具体动作

1. 域名切换：站点常备多个候选域名；逐个测速挑延迟最低的；若站点有动态域名机制，规则里不要写死单一域名。排查结论注明日期——候选域名时效性强。
2. 接口变更：抓一次真实响应，和源内契约逐字段比对；常见变更是字段改名、包了一层 data、列表分页参数变化。修完在帖子里附「变更前后契约对比」。
3. 鉴权升级：只比对「缺了什么头、什么算法类目」的结构层面；具体样本与实现讨论到「接口与鉴权」节点（等级门槛内），公开帖不贴可用样本。
4. 反爬升级：先确认内容在浏览器里确实可见（排除站点挂了）；再判断是 JS 渲染依赖还是行为检测；WebView 路径的规则改造参考各平台的 WebView 章节教程。

排查纪律

• 先定位分类，再动手改规则；四类原因的修法完全不同，混着修会把源越改越乱。
• 每次修复在帖子里注明分类与排查日期，这是修复经验沉淀的核心。
• 修完按七级层级验证到 L6 真机再发布。

常见误判

• 「源挂了」其实是本地网络问题：先换网络环境复测再报修。
• 「正文空」其实是那本书的章节本身缺失：换一本书验证再下结论。
• 「搜索空」其实是触发频率限制：等几分钟再试，报修时注明频次。