代理IP API 返回 HTTP 200，但 data 是空数组，或者接口提示“没有可用节点”时，先不要连续重试，也不要立刻把地区条件放宽。空结果可能是筛选条件没有匹配资源，也可能是套餐、时间窗口、分页或配额已达到边界。先保存原始请求和响应，再按接口层、参数层、资源层和账号层定位。
先按 HTTP 状态码分层
用占位符做一次不跟随重定向的请求，避免把真实令牌写进 Shell 历史：
curl -i --max-time 10
-H "Authorization: Bearer TOKEN"
"https://api.example.test/v1/proxies?country=US&protocol=socks5&page=1&page_size=20"- 200 + 空数组：接口正常处理了请求，但当前条件没有返回资源，重点查筛选条件、库存、时间窗和分页。
- 400：参数名称、类型、枚举值或编码不符合接口定义，先对照文档和请求日志。
- 401/403：令牌、账号权限、来源白名单或套餐权限有问题，不要用更高并发掩盖认证失败。
- 429：触发频率或配额限制，应读取
Retry-After（如果服务提供），采用退避并减少请求。 - 5xx 或超时：更像服务端或网络链路异常，记录时间、请求 ID 和重现条件后再联系服务商。
用最小查询找出是哪一个条件筛空
不要一次提交十几个参数。先只保留必需字段，再每次增加一个条件：
# 仅验证接口和账号
curl -sS -H "Authorization: Bearer TOKEN"
"https://api.example.test/v1/proxies?page_size=1"
# 依次增加国家、协议、IP类型和会话要求
curl -sS -H "Authorization: Bearer TOKEN"
"https://api.example.test/v1/proxies?country=US&protocol=http&type=datacenter"地区代码、协议名称、住宅/机房标识、静态周期和 IPv4/IPv6 枚举都应以接口文档为准。常见错误是把“美国”写成中文，把 socks5 写成服务商自定义的 socks，或把“静态”理解成固定出口而实际参数要求会话时长。对每次查询记录参数和返回数量，很快就能找到导致空结果的条件。
检查库存、时间窗口与分页
部分接口只返回当前可租用或健康检查通过的节点。指定城市、运营商、住宅网络、固定时长后，资源范围会明显缩小；短时维护也可能让某个过滤组合暂时无库存。若接口支持 available、expires_before、session 或地区标签，应确认时间格式和时区。
还要检查分页语义。有的接口用 page/page_size，有的用游标 cursor；游标过期、页码超出范围或把 limit=0 传入，都可能得到空结果。先请求第一页和最小页大小，再依据响应里的 next_cursor 或 total 继续读取，不要自行猜测分页字段。
核对套餐、余额与并发配额
“接口能调用”不代表账号有权获取所有资源。检查套餐允许的协议、地区、IP类型、并发连接数、每日提取次数、余额和有效期。若供应商把配额不足也返回 200 空数组，应把账号状态和请求日志一起提交，不能仅凭状态码判断正常。
应用侧还可能有缓存：旧令牌、旧地区参数或本地缓存的空结果会让新查询看起来仍然没有节点。给响应记录请求时间、请求 ID、参数摘要和数据数量，缓存键至少应包含地区、协议、IP类型和会话要求；不要把令牌写进日志。
把“无结果”纳入可控的降级策略
- 先保留原始业务条件，等待接口规定的退避时间。
- 只在业务允许时放宽一个条件，例如从城市级改为国家级，并在日志中标记降级。
- 若仍为空，切换到已审核的备用资源池，而不是随机使用未知地区节点。
- 达到重试上限后返回明确错误，让上层任务决定排队、人工处理或暂停。
- 恢复后复核出口地区、协议和会话属性，确认降级没有改变业务语义。
常见问题
API 返回 200 空数组，是服务商故障吗？
不一定。它可能表示条件没有匹配资源、当前库存为空、分页越界或套餐无权访问。先用最小查询和状态码对照。
把国家和协议参数删掉就能拿到IP吗？
可能拿到，但不一定符合业务要求。只有在目标允许时才放宽条件，并把降级记录下来，避免把错误地区节点当成正常结果。
为什么第一页为空，换页却有数据？
可能是游标或页码使用错误，也可能是接口按健康状态动态分页。按照文档从第一页获取有效游标，不要手工拼接游标。
429 后能不能马上换一批令牌继续请求？
不建议。这样可能触发更严格的风控或违反服务条款。应尊重 Retry-After、降低频率并核对账号配额。
