企业官网建设流程全解析

Jackett 报 429 Rate limited 怎么办？TooManyRequestsException 排查与修复指南

【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett

你是否在日志里见过这样的报错：站点返回 429，Jackett 打出Rate limited，搜索结果直接空白？Jackett 是给 Sonarr、Radarr 这类客户端提供 torrent 追踪器统一搜索接口的工具。当查询打得太密，追踪器会拒绝请求。读完本文，你能判断自己是否中了这个"病"，知道该等多久，以及怎么让它不再反复出现。

快速自检：确认是不是频率限制

🧭 对照下面 5 点，命中 3 个以上基本可以确诊：

1. 日志或 API 响应里出现Rate limited，HTTP 状态码是429，Torznab 错误码 900。
2. 只有部分索引器（indexer）出错，其余站点查询正常。
3. 报错是间歇性的：不做任何改动，过几分钟再搜就成功了。
4. Jackett 服务本身运行正常，没有进程崩溃或整体挂死。
5. 接口返回头里带Retry-After，值是一个秒数——这是站点告诉你"等多久再来"。

对应源码在 TooManyRequestsException.cs，它就是一个普通异常外加一个RetryAfter（等待时长）属性，会从响应头里自动解析等待时间。

根源剖析：429 是怎么被处理掉的

追踪器（tracker）为了保护服务器，都会限制单位时间内的查询次数。Jackett 每次搜索都要替客户端去请求这些站点，查询多了就会撞上限制。

关键在于 Jackett不会在一次请求里死等、反复重试。它的策略是"记一笔账，先退避"：

具体链路是这样的：

• 索引器收到 429 就抛出TooManyRequestsException，比如 FileList.cs 和 AvistazTracker.cs 里都有这个判断。
• BaseIndexer.cs 第 393 行捕获它，把RetryAfter秒数记成该索引器的"冷却截止时间"，冷却期内这个索引器被视为不健康，Jackett 不会再去打扰它。
• 最终 ResultsController.cs 把错误透传给客户端：响应头写上Retry-After（站点没给就默认 1 分钟），HTTP 状态返回 429。

所以结论先行：这个错误是设计好的退避信号，不是故障。Jackett 自己会等，你只需要别让"重试的人"太心急。

分步修复：从最省事的开始

第 1 步：看 Retry-After 的秒数，等完再查

成本最低的一步。打开返回的响应头，看Retry-After是多少秒，等到时间过了再发一次查询。

做完应该看到：同一个索引器搜索成功，日志里不再出现Rate limited。

第 2 步：在 Dashboard 和日志里定位是哪个索引器

打开 Jackett 的 Dashboard 页面，看索引器列表。进入冷却期的索引器状态会显示为不健康（红/黄），一眼就能对上名字。

再翻日志，搜Rate limited，每次出现都对应一个索引器。日志会告诉你限流发生在哪个站点、什么时间。

做完应该看到：你明确知道是哪一两个站点在被限，而不是全局故障。

第 3 步：压低客户端的搜索频率

查询的来源通常是 Sonarr、Radarr、Lidarr 的定时同步任务。三个客户端的定时任务挤在同一分钟，等于瞬间三倍请求量。

做法：把各客户端的"同步/搜索间隔"调大，并且错开它们的执行时间点（比如一个每 15 分钟、一个每 30 分钟，起始时间不同）。

做完应该看到：日志里 429 的出现频率明显下降，最好几天不出现一次。

第 4 步：对反复被限的索引器单独处理

如果某个站点持续触发 429，说明它限制严格或你的使用量确实超了。两个选择：

• 减少对该站点的依赖，优先使用不限流的站点；
• 在 Jackett 里删除该索引器配置后重新添加（顺带检查 Cookie 或 API 密钥是否过期，配置失效有时也会引发异常请求）。

做完应该看到：该站点不再出现在限流日志里。

调优与加固：让限流不再找你麻烦

1. 利用查询缓存：Jackett 支持缓存查询结果，相同搜索词在缓存有效期内直接返回，不会重复打站点。客户端查询时尽量走缓存，重复搜索几乎零成本。
2. 分散请求时间：多客户端、多索引器时，把请求在时间轴上摊开，避免瞬时并发尖峰。
3. 监控限流趋势：定期在日志里统计Rate limited出现次数（行内命令：grep -c "Rate limited" jackett.log）。趋势上涨就该回头查客户端配置了。
4. 进阶：改退避策略：如果你是自托管且熟悉 C#，RetryAfter的解析和冷却时长都在前面提到的源码文件里，可以扩展成指数退避等策略。

延伸与验证

下次再看到 429，你已经知道该等多久、该查谁了。相关源码与文档：

• README.md
• TooManyRequestsException.cs
• BaseIndexer.cs
• ResultsController.cs
• 索引器定义目录

【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett