NewAPI 渠道故障重试设置方法

📋 NewAPI 渠道故障重试设置方法

基于 GitHub Issue #2953 回复总结

📎 原文链接：GitHub – new-api Issue #2953: 渠道亲和性缓存在失败时无法自动切换渠道

✅ 核心结论

这是个人配置问题，未配置重试次数，配置后就可以解决渠道失败自动切换的问题。

🔧 配置位置

📊 状态码范围参考

代码位置：status_code_ranges.go L19-L28

var AutomaticRetryStatusCodeRanges = []StatusCodeRange{
    {Start: 100, End: 199},   // 1xx
    {Start: 300, End: 399},   // 3xx
    {Start: 401, End: 407},   // 401-407
    {Start: 409, End: 499},   // 409-499 ← 429 在这个范围内
    {Start: 500, End: 503},   // 500-503
    {Start: 505, End: 523},   // 505-523
    {Start: 525, End: 599},   // 525-599
}

📝 配置步骤

步骤 1：设置重试次数

1. 登录 NewAPI 管理后台
2. 进入 运营设置 → 通用配置
3. 找到 重试次数 配置项
4. 设置重试次数为 3
5. 保存配置

步骤 2：确认状态码范围

1. 进入 运营设置 → 监控配置
2. 查看状态码范围配置
3. 429 已在 409-499 范围内，无需修改

📋 配置对比

✅ 配置完成后的效果

当渠道返回以下状态码时，会自动重试其他渠道：

• 429 (配额耗尽)
• 500-503 (服务器错误)
• 505-523 (网络错误)
• 401-407 (认证错误)
• 409-499 (其他客户端错误)

💡 总结

问题根源：未配置重试次数（默认为 0，不重试）

解决方法：在 运营设置 → 通用配置 中配置重试次数为 3

状态码范围：代码中已默认配置好，429 在自动重试范围内，无需修改

本文整理自 NewAPI GitHub Issue #2953，感谢原作者的分享！