Jackett IndexerException 错误又刷屏三步定位实战指南完整版【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett给 Jackett 配置好一批站点后你在仪表盘点了一次手动搜索日志里却蹦出一长串 Jackett IndexerException形如Exception (1337x): Login failed。先别慌它只是 Jackett 的统一错误信封拆开就能找到真正的病根。报错解读——Jackett 的 IndexerException 在传递什么信号Jackett 里每个索引器Indexer可以理解为对一个 torrent 站点的适配插件发起查询时任何失败都会被打包成一个IndexerException再向上抛。也就是说它传递的信号是两件事哪个索引器挂了底层真实异常是什么。你在日志里看到的典型样子[ERR] Jackett.Common.IndexerException: Exception (1337x): Login failed [ERR] Jackett.Common.IndexerException: Exception (mikan): Could not extract releases [ERR] Jackett.Common.IndexerException: Exception (yts): The remote server returned an error: (503)括号里的站点标识来自索引器的Id冒号后面的内容才是真正需要你处理的信息。关键构件如下IndexerException类继承自标准Exception是所有索引器查询失败的统一包装类定义在 src/Jackett.Common/IndexerException.csIndexer属性指向出错的具体索引器实例日志前缀Exception (xxx)正是由它的Id拼接而成该文件第 22 行抛出位置BaseIndexer的查询入口捕获任意异常后统一包成IndexerException重抛见 src/Jackett.Common/Indexers/BaseIndexer.cs 第 399~404 行持久化字段错误消息还会被写入索引器配置的LastError字段仪表盘索引卡片上显示的就是它写入逻辑在 src/Jackett.Server/Controllers/IndexerApiController.cs 第 143 行症状对号——你属于哪一种触发场景现象可能原因自查方法错误信息含 login / cookie 字样该索引器状态变红登录态失效Jackett 靠保存的 Cookie 维持站点登录Cookie 过期即登录失败浏览器里手动登录该站点确认账号仍有效核对 src/Jackett.Common/Models/IndexerConfig/ConfigurationData.cs 第 17 行定义的CookieHeader项是否为空或过期多个索引器几乎同时报错手动搜索会并行打向所有已启用索引器任务用Task.WhenAll聚合一个慢/挂会显得集体翻车看日志时间戳是否成簇出现再单独对某一个索引器搜索确认是否个别问题聚合逻辑见 src/Jackett.Server/Controllers/ResultsController.cs 第 270~296 行单个索引器持续报错浏览器里站点一切正常站点页面改版解析规则selector失配解析不到内容就抛异常在浏览器查看站点实际 HTML与 src/Jackett.Common/Definitions/ 下对应 yml 定义里的选择器逐条比对报错间隔越来越长随后自行恢复内置指数退避首次失败后等 10 分钟之后每次翻倍、封顶 1 天窗口过后自动重试观察仪表盘该索引器状态从异常恢复退避公式在 src/Jackett.Common/Indexers/BaseIndexer.cs 第 401 行ErrorStatusValidity起步 10 分钟MaxStatusValidity封顶 1 天处理方案——按推荐顺序动手第一步读日志拆出真正的底层异常改什么Jackett 的日志文件默认工作目录下的jackett.log。怎么改过滤出目标错误看清哪个索引器 哪句底层消息grep -n IndexerException jackett.log | tail -20如何验证能明确说出是 1337x 的 login 问题还是mikan 的解析问题说明诊断成立再进入对应步骤。第二步登录态失效重贴一次 Cookie这是 Jackett IndexerException 最高频的一种诱因。改什么对应索引器配置里的 Cookie。怎么改用 Chrome 打开该站点并手动登录按 F12 打开开发者工具切到 Network网络标签刷新页面点第一个文档请求在 Request Headers 里复制整段Cookie值粘贴回 Jackett 该索引器的 Cookie 配置项并保存。如何验证对该索引器手动搜索一次有结果返回、日志不再出现 login 类报错即修复成功。第三步解析失配更新定义再核站点改什么Jackett 版本或对应站点的定义文件。怎么改先把 Jackett 升级到最新版定义文件随版本更新若仍报错对照 src/Jackett.Common/Definitions/ 下该站点的 yml检查 selector 是否还匹配站点当前 HTML——站点改版时只能等上游定义跟进不必自己硬改规则。如何验证升级后同一搜索不再报Could not extract类错误浏览器里站点页面结构若已大改则属于等待上游修复。第四步触发限流等退避窗口别硬刷改什么你的操作习惯。怎么改停止反复点手动搜索让内置退避跑完10 分钟起步、逐次翻倍、封顶 1 天窗口过后 Jackett 会自动重试。如何验证索引器状态从异常自动恢复为正常且日志中该类错误的出现频率明显下降。防复发清单——一次修好不再踩坑 报错先记录哪个索引器 底层异常再动手避免盲目重配 养成检查各站点 Cookie 有效期的习惯过期前主动更新⏱ 多索引器手动搜索之间留间隔别一次性全量连点定期升级 Jackett让 Definitions 目录的定义跟进站点改版每周扫一眼日志中 IndexerException 的出现频率趋势比单条更重要延伸阅读——源码与文档导航src/Jackett.Common/IndexerException.cs异常类本体的定义Indexer属性与消息拼接逻辑都在这里src/Jackett.Common/Indexers/BaseIndexer.cs所有索引器的基类查询入口的捕获、退避与健康状态判断src/Jackett.Server/Controllers/ResultsController.cs手动搜索如何把IndexerException聚合成 UI 上的错误状态src/Jackett.Common/Definitions/各站点的 yml 定义文件解析规则失配时到这里比对README.md项目介绍与快速上手适合刚接触 Jackett 的读者回到开头那个场景下次仪表盘再飘红你只需记住先拆信封、再对症状、后动手那条刷屏的 IndexerException 就会变成一份清清楚楚的诊断书。【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考