交易所连接失败排查
发布于 2026年6月22日 · 更新于 2026年10月16日
测试连接不通过、钱包授权失败，或原本正常的账户变成异常？先记下弹窗或页面上的提示原文，再对照下面的表格处理。入口：账户 → 交易账户。完整接入步骤见连接交易所。
测试连接时出现这些提示怎么办？
点 测试连接 后，结果显示在弹窗正文里。
| 提示原文 | 原因 | 怎么处理 |
|---|---|---|
| 连接测试未通过，请检查 API 凭证与权限后重试。 | 交易所拒绝了这组凭证，或 Key 没有交易权限 | 重新复制 API Key 和 Secret，注意不要带空格；确认勾选了读取和交易 |
| 交易所凭证字段不完整。 | 有必填字段为空 | OKX、Bitget 要填 Passphrase；Aster 要填 Wallet Address |
| 请输入账户名称。 | 账户名称为空 | 填一个名称 |
| 检测到提现权限，请关闭提现权限后重新测试。 | Key 开了提现权限，本次测试不算通过 | 到交易所关掉提现权限，再重新测试 |
| 白名单 IP 尚未加载完成，请稍后重试。 | 弹窗里的白名单 IP 还没显示出来 | 等 IP 出现后再测试 |
| 服务暂时不可用（网关错误），请稍后重试。这通常与交易所密钥无关。 | AlphaFox 服务端暂时不可用 | 稍后原样重试，不用改 Key |
| 连接测试超时，请稍后重试。 | 交易所或网络响应过慢 | 稍后重试；交易所维护期间也会超时 |
| 连接信息已修改，请重新测试。 | 测试后又改了凭证 | 再点一次 测试连接 |
| 未通过连接测试前禁止保存。 | 还没通过测试就点了保存 | 先让测试通过 |
出现「检测到提现权限」不是可以忽略的警告。Key 一旦泄露，提现权限意味着资产可以被转走。关掉提现权限之前，这把 Key 无法保存。
交易所返回了具体报错怎么办？
交易所拒绝请求时，弹窗会显示翻译后的交易所报错。常见的几类：
| 提示原文（节选） | 怎么处理 |
|---|---|
| 当前 IP 不在该 API Key 的白名单内。请在交易所添加本服务出口 IP 后重试。（Bybit、Gate 会显示交易所名称） | 复制弹窗第 2 步的白名单 IP，加到这把 Key 的 IP 访问限制里 |
| Binance API Key 无效、IP 未放行，或权限不足。请检查密钥与白名单后重试。 | 依次检查 Key 是否复制完整、白名单 IP、读取和交易权限 |
| 当前 Binance API Key 未开启 U 本位合约交易权限。请在币安为该密钥开启合约交易后重试。 | 在币安 API 管理里为这把 Key 开启合约交易 |
| Passphrase 不正确，请检查后重试。 | OKX、Bitget 填创建 Key 时自己设置的 Passphrase，不是登录密码 |
| OKX 签名校验失败。请检查 API Secret、Passphrase 与服务器时间。 | 重新复制 Secret，核对 Passphrase |
| 该 Gate API Key 为只读。请换用具有交易权限的密钥。 | 新建一把带交易权限的 Key |
| Bybit API Key 无效。请确认密钥、环境（正式/Demo）与域名是否匹配。 | 使用正式环境创建的 Key |
| 交易所鉴权失败。请检查 API Key、密钥权限与 IP 白名单。 | 按凭证、权限、白名单的顺序逐项检查 |
Hyperliquid 钱包授权为什么失败？
Hyperliquid 用浏览器钱包签名授权，失败通常出在钱包本身，或主钱包还没在 Hyperliquid 入金。
| 提示原文 | 怎么处理 |
|---|---|
| 未检测到可用钱包。请在钱包列表中选择并完成连接后重试。 | 安装或启用浏览器钱包，在弹出的钱包列表里完成连接 |
| 已取消钱包连接。 | 重新点 连接钱包并授权 |
| 钱包没有返回可用账户，请解锁钱包后重试。 | 解锁钱包再试 |
| 钱包没有返回签名，请重新确认授权。 | Agent 授权和 Builder Fee 授权两次签名都要确认 |
| HyperLiquid 授权请求缺少必要签名动作，请重新发起绑定。 | 关闭弹窗后重新发起 |
签名都确认了仍失败时，确认主钱包已经在 Hyperliquid 入金并完成账户初始化（弹窗里的 打开 HyperLiquid Portfolio 可以查看）。想换一个钱包，点 重新选择钱包。
Aster 授权提示「已连接钱包与 API Key 中的钱包地址不一致，请切换钱包后重试。」时，切换到 API Key 对应的 Aster 主钱包再授权。
原本正常的账户为什么变异常了？
在交易账户页选中这个账户，右侧状态显示「权限异常」「同步异常」或「未连接」时，原因通常在交易所一侧：Key 被删除或吊销、权限被改、IP 白名单被改。
在交易所修好或新建 Key
能在交易所恢复原 Key 的权限和白名单，就直接恢复。原 Key 已删除时，新建一把只开读取和交易、加好白名单 IP 的 Key。
把新 Key 添加为新连接
按连接交易所添加并测试通过。已保存的连接不能修改凭证。
给策略换上新连接
先停止策略，再在策略配置里把连接换成新账户，然后点 启动 / 重启。策略运行时更换会提示「策略运行中无法更换 API，请先停止策略。」
删除旧连接
确认没有策略再用它之后，删除旧连接。
AlphaFox 托管的 Hyperliquid 交易账户另有两种提示：
- 「该交易账户已入金，但还没有完成代理授权（用于交易的连接器签名人）。没有授权，这个账户无法下单。」点 重试授权。
- 「交易账户已就绪，但交易连接不可用。常见原因是主站删除了 API 连接。请重新连接，无需再次充值。」点 重新连接交易账户。
为什么删不掉连接？
| 提示原文 | 怎么处理 |
|---|---|
| 该 API 连接已被策略占用，请先删除或迁移对应策略。 | 到「我的策略」停止并删除该策略，或把策略换到别的连接 |
| 这是交易账户自动创建的交易连接，不能当普通 API Key 删除。要停用请先停策略。 | 这是托管交易账户的连接，停止使用它的策略即可 |
以上都试过还是不行怎么办？
记下交易所、提示原文和发生时间，发到 support@alphafox.app。不要在反馈里包含完整的 API Key、Secret 或私钥。