# 常见错误码与处理建议

汇总实名、白名单、来源网络、认证和出口路由相关业务码及恢复方式。

错误码用于确定失败阶段，不能单独证明网关、出口或客户端存在故障。排查时同时保留请求时间和请求 ID。

## 资格与来源

- `10601`：请先完成实名认证。
- `10428`：账密来源为中国大陆 IPv4。
- `10429`：账密来源为 IPv6。
- `10430`：账密来源无法识别。

## 白名单

- `10411`：当前操作需要来源白名单。
- `10423`：来源属于不允许添加的 IPv4 范围。
- `10424`：该 IP 已被其他账号占用。
- `10425`：该 IP 已在当前账号白名单中。
- `10427`：当前白名单不接受 IPv6。
- `10431`：批量白名单操作存在失败项。查看 `success_count`、`failed_count` 和 `failed_items`，只处理失败项目。

## 代理与路由

- HTTP 407：检查账密或来源白名单认证。
- `10502`：代理认证失败。
- `10504`：当前代理出口路由不可用，应有限退避后重试。

## 提交诊断

- 提供业务码、HTTP 状态、请求 ID、时间和脱敏阶段。
- 不提交密码、完整代理 URL 或控制台会话。