Jackett TooManyRequestsException 429 限流报错排查与 5 分钟恢复指南【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett日志里刷出TooManyRequestsException、Torznab 返回带Retry-After头的 429 响应先别慌这只是 Jackett一个把 Sonarr、Radarr、Prowlarr 等客户端查询翻译成各家 tracker 请求的轻量 API 网关触发了上游限流跟着本文操作5 分钟内可定位并恢复。识别 429 报错的 3 个特征日志、响应头与触发场景⚠️ 三步确认别急着改配置现象客户端拉取结果失败Torznab 响应体是 error XMLcode 900HTTP 状态码 429响应头里通常挂着Retry-After: 秒数。日志特征Jackett 日志出现Rate limited或TooManyRequestsException对应某条索引器查询记录。触发场景挑中的那几条多半就是你现在的情况Sonarr、Radarr、Prowlarr 都在按分钟轮询请求叠着发某个客户端的刷新间隔调得比 tracker 容忍度还短一次搜索勾选了十几个索引器瞬间并发打满刚批量新增索引器全部处于首次探测的密集请求期一张图看懂 429 限流异常的发生与重试链路整条链路一句话tracker 嫌请求太密就回 429 并附带建议等待时长Jackett 把等待时长塞进异常对象里既向上游报 429也让自己在下一轮之前先歇够。异常的定义和Retry-After解析逻辑见 TooManyRequestsException.cs。最快恢复服务的排查顺序3 步从冷却到根治Step 1 先让服务自己退烧5 分钟内操作打开 Jackett 的 Manual search 页面逐个索引器手动发起一次搜索找出返回 429 的那几个然后关掉终端等待 10~15 分钟再重复。生效标志状态由失败转回绿色搜索正常出结果。背景BaseIndexer.cs 中的基类索引器在查询失败后会把该索引器标记为 failing后续查询自动延迟——基准 10 分钟起步、逐次翻倍、封顶 24 小时多数情况等待即可自愈。Step 2 削减总请求量治本操作禁用用不上的索引器把 Sonarr/Radarr 里各索引器的刷新间隔从 15 分钟拉到 30~60 分钟多个客户端的整点刷新错开别放在同一时刻。生效标志观察 24 小时日志不再出现Rate limited。Step 3 对高敏索引器单独降频针对性操作FileList、Avistaz 系、Postman 类 API 索引器各自内置了 429 拦截源码如 FileList.cs、AvistazTracker.cs在 Manual search 页逐个点测定位后只给这几个把客户端轮询周期调长。生效标志其余索引器不受影响被点名者的 429 归零。进阶改码自定义重试与退避策略可选在TooManyRequestsException的RetryAfter解析处改成指数退避按失败次数翻倍计算等待时长并设上限替代目前直接用响应头秒数、缺省 60 秒的做法。给特定索引器覆写查询入口在发起请求前追加一段独立冷却等效于给这个站点单独限速。别让 429 复发参数加固对照Jackett 内部的重试常量改默认值需动源码配置项默认值建议值理由Retry-After 解析失败时的等待60 秒120 秒ResultsController.cs 在头部缺失时按 1 分钟回给客户端tracker 限流窗口普遍更长失败后挂起基准10 分钟保持不变基类指数退避的起点配合客户端降频已足够挂起时长上限24 小时保持不变封顶防止坏索引器被无限期放弃正常状态的有效期2 × 缓存 TTL随缓存调整决定健康判定多久复核一次你在客户端侧真正能拧的参数配置项现状建议值理由Sonarr / Radarr 索引器刷新间隔15 分钟30~60 分钟直接压低请求频率是复发主因Jackett 缓存 TTL30 分钟≥30 分钟命中缓存的查询不打到 tracker启用索引器数量十几个只留常用的单条搜索的并发扇出立刻变小按先客户端、后 Jackett 缓存、最后动源码的顺序逐项落地每改一项观察一天稳定 24 小时无 429 再停手排查中途再撞 429回到 Step 1 等待窗口别叠加新改动。延伸资源TooManyRequestsException.cs异常定义与Retry-After解析BaseIndexer.cs基类捕获、挂起与指数退避ResultsController.cs对客户端返回 429 与等待头官方说明Jackett 安装与使用文档【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Jackett TooManyRequestsException 429 限流报错排查与 5 分钟恢复指南
Jackett TooManyRequestsException 429 限流报错排查与 5 分钟恢复指南【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett日志里刷出TooManyRequestsException、Torznab 返回带Retry-After头的 429 响应先别慌这只是 Jackett一个把 Sonarr、Radarr、Prowlarr 等客户端查询翻译成各家 tracker 请求的轻量 API 网关触发了上游限流跟着本文操作5 分钟内可定位并恢复。识别 429 报错的 3 个特征日志、响应头与触发场景⚠️ 三步确认别急着改配置现象客户端拉取结果失败Torznab 响应体是 error XMLcode 900HTTP 状态码 429响应头里通常挂着Retry-After: 秒数。日志特征Jackett 日志出现Rate limited或TooManyRequestsException对应某条索引器查询记录。触发场景挑中的那几条多半就是你现在的情况Sonarr、Radarr、Prowlarr 都在按分钟轮询请求叠着发某个客户端的刷新间隔调得比 tracker 容忍度还短一次搜索勾选了十几个索引器瞬间并发打满刚批量新增索引器全部处于首次探测的密集请求期一张图看懂 429 限流异常的发生与重试链路整条链路一句话tracker 嫌请求太密就回 429 并附带建议等待时长Jackett 把等待时长塞进异常对象里既向上游报 429也让自己在下一轮之前先歇够。异常的定义和Retry-After解析逻辑见 TooManyRequestsException.cs。最快恢复服务的排查顺序3 步从冷却到根治Step 1 先让服务自己退烧5 分钟内操作打开 Jackett 的 Manual search 页面逐个索引器手动发起一次搜索找出返回 429 的那几个然后关掉终端等待 10~15 分钟再重复。生效标志状态由失败转回绿色搜索正常出结果。背景BaseIndexer.cs 中的基类索引器在查询失败后会把该索引器标记为 failing后续查询自动延迟——基准 10 分钟起步、逐次翻倍、封顶 24 小时多数情况等待即可自愈。Step 2 削减总请求量治本操作禁用用不上的索引器把 Sonarr/Radarr 里各索引器的刷新间隔从 15 分钟拉到 30~60 分钟多个客户端的整点刷新错开别放在同一时刻。生效标志观察 24 小时日志不再出现Rate limited。Step 3 对高敏索引器单独降频针对性操作FileList、Avistaz 系、Postman 类 API 索引器各自内置了 429 拦截源码如 FileList.cs、AvistazTracker.cs在 Manual search 页逐个点测定位后只给这几个把客户端轮询周期调长。生效标志其余索引器不受影响被点名者的 429 归零。进阶改码自定义重试与退避策略可选在TooManyRequestsException的RetryAfter解析处改成指数退避按失败次数翻倍计算等待时长并设上限替代目前直接用响应头秒数、缺省 60 秒的做法。给特定索引器覆写查询入口在发起请求前追加一段独立冷却等效于给这个站点单独限速。别让 429 复发参数加固对照Jackett 内部的重试常量改默认值需动源码配置项默认值建议值理由Retry-After 解析失败时的等待60 秒120 秒ResultsController.cs 在头部缺失时按 1 分钟回给客户端tracker 限流窗口普遍更长失败后挂起基准10 分钟保持不变基类指数退避的起点配合客户端降频已足够挂起时长上限24 小时保持不变封顶防止坏索引器被无限期放弃正常状态的有效期2 × 缓存 TTL随缓存调整决定健康判定多久复核一次你在客户端侧真正能拧的参数配置项现状建议值理由Sonarr / Radarr 索引器刷新间隔15 分钟30~60 分钟直接压低请求频率是复发主因Jackett 缓存 TTL30 分钟≥30 分钟命中缓存的查询不打到 tracker启用索引器数量十几个只留常用的单条搜索的并发扇出立刻变小按先客户端、后 Jackett 缓存、最后动源码的顺序逐项落地每改一项观察一天稳定 24 小时无 429 再停手排查中途再撞 429回到 Step 1 等待窗口别叠加新改动。延伸资源TooManyRequestsException.cs异常定义与Retry-After解析BaseIndexer.cs基类捕获、挂起与指数退避ResultsController.cs对客户端返回 429 与等待头官方说明Jackett 安装与使用文档【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
 完全指南：原子更新、Upsert 与返回值控制)
