交易所连接失败排查

添加连接时测试不通过，或已有连接变成异常？按顺序检查。正确流程也可对照连接交易所。

连接测试为什么不通过？

绝大多数测试失败都出在四件事上：凭证没复制完整、Key 少勾了交易权限、交易所那边没加白名单 IP、OKX 或 Bitget 的 Passphrase 填错。按这个顺序查。

Key 和 Secret 是否复制完整、有没有多余空格。OKX / Bitget 记得填对 Passphrase（创建 Key 时自己设的那个）。

必须同时有读取和交易权限。只读 Key 会提示权限不足。

交易所开了 IP 白名单的，必须把弹窗里的白名单 IP 加到交易所 API 设置里。没加的典型报错：权限或签名错误。

交易所维护或风控期间会连不上。

测试时如果提示「检测到提现权限」，先去交易所把提现权限关掉再继续。这是资产安全问题，不是可以忽略的警告。

Hyperliquid 不用 API Key，而是靠钱包签名授权，所以它的失败原因通常出在浏览器钱包本身，或者主钱包没入金，而不是权限配置。

提示	处理
未检测到浏览器钱包	安装或启用 MetaMask / Rabby
钱包没有返回账户	解锁钱包再试
钱包没有返回签名	两次签名（Agent + Builder Fee）都要确认
授权后仍失败	确认主钱包已在 Hyperliquid 入金（有 USDC）

本来能用的连接出问题，原因基本都在交易所那一侧，而不是 AlphaFox。打开连接的健康度面板，看「最近失败原因」，常见的是 Key 被吊销、权限被改、白名单变了。在交易所改好之后，回来点 一键重试同步。

提示被策略占用，说明还有 Trader 绑在这个连接上。先去「我的策略」删除或迁移那个策略，再回来删连接。

记录交易所、错误提示原文和发生时间，发到 support@alphafox.app。不要在反馈里包含完整的 API Key 或 Secret。