错误说明

移动产品的错误信封与住宅一致——HTTP 状态码 + helodata 码 + X-Helodata-Error-Code。完整代码表见 住宅错误说明。本页列移动特有代码。

移动特有网关代码

状态码	helodata 码	X-Helodata-Error-Code	含义	处理
403	—	kyc-required	账号触发风险复核，KYC 待完成	见 KYC
400	20002	sesstime-out-of-range	TTL > 60（移动上限）	减小 sesstime
502	40001	carrier-blackout	指定 ASN 运营商出现整网故障	切换 ASN 或 5 分钟后重试
502	40001	pool-empty-mobile	无匹配移动 IP（通常因 state+city+ASN 过度约束）	先去 city，再去 state
522	—	device-offline	选中的设备在请求中途掉线	重试，网关会自动换一个设备

更多次重试 + 退避

移动设备来去自由，瞬时错误率约为住宅的 2–3 倍。合理的重试策略：

RETRYABLE_GATEWAY = {429, 502, 522, 524}
MAX_RETRIES = 5

import time, random
def request_with_retry(fn):
    for attempt in range(MAX_RETRIES):
        r = fn()
        if r.status_code not in RETRYABLE_GATEWAY:
            return r
        time.sleep(2 ** attempt + random.random())   # 指数退避 + jitter
    return r                                          # 最后一次响应

目标层错误

直通透传，同住宅。请始终检查 X-Helodata-Exit-IP——若它与目标的 403 同时出现，说明拒绝来自目标而非 helodata。

运营商限流

移动运营商对自己的 IP 会限流。目标的 429 若不带 X-Helodata-Error-Code，多半是该 IP 触发了运营商限流。请换 ASN、扩大会话多样性、或降低单 IP 速率。

相关

• 住宅错误说明 — 完整代码表
• 407 — 认证问题
• 522 — 超时