常见 Hyperliquid 错误信息详解
在使用 Hyperliquid 交易时，偶尔会弹出错误提示。这些错误信息往往简短，没有详细说明，让第一次遇到的用户摸不着头脑。本文整理了最常见的错误类型，解释其含义，并给出对应的处理方法。
错误类型总览
Hyperliquid 的错误大致分为四类：
账户状态类：保证金不足、账户未初始化等
订单参数类：价格超出范围、数量无效等
合约/交易对类：交易对暂停、仓位超限等
连接与签名类：钱包签名失败、连接超时等
账户状态类错误
"Insufficient margin" / 保证金不足
含义：提交订单时，账户可用保证金不足以覆盖该仓位所需的初始保证金。
处理方法：
减小订单规模，降低所需保证金
降低杠杆倍数
向账户充入更多 USDC
关闭部分现有仓位以释放保证金
保证金计算逻辑可参阅 Hyperliquid 文档，理解交叉保证金与逐仓保证金的区别有助于预判该错误。
"Account not found" / 账户未找到
含义：钱包地址在 Hyperliquid 上没有初始化记录，通常出现在首次使用时。
处理方法：完成初次充值并签署必要的初始化交易，账户即可激活。确保使用的是正确的钱包地址。
"Leverage too high" / 杠杆超限
含义：所设置的杠杆倍数超过该交易对允许的最大值。
处理方法：在下单前检查该交易对的最大杠杆限制，调整至允许范围内。
订单参数类错误
"Price out of range" / 价格超出范围
含义：提交的限价单价格偏离当前标记价格过大，超出协议允许的价格区间。
处理方法：调整限价单价格，使其接近当前市场价。Hyperliquid 对挂单价格有一定的偏离限制，以防止极端错误挂单。
"Size too small" / 数量过小
含义：提交的订单数量低于该交易对的最小交易单位。
处理方法：增大下单数量，或改换到最小单位更小的交易对。
"Invalid order type" / 无效订单类型
含义：提交的订单参数组合无效，例如在不支持的场景下使用了特定订单类型。
处理方法：重新检查订单参数，确认所选订单类型与当前市场状态兼容。
合约与交易对类错误
"Market is paused" / 市场暂停
含义：该交易对当前处于暂停状态，可能因协议维护、价格异常熔断或其他原因触发。
处理方法：等待市场恢复正常。关注 Hyperliquid 官方公告获取最新状态。现有仓位在市场暂停期间通常仍维持原状。
"Position size limit exceeded" / 仓位超限
含义：当前账户在该交易对的持仓名义价值已达到协议设定的上限。
处理方法：减小新增订单规模，或先平掉部分仓位后再操作。仓位上限的设计是为了防止单一账户操纵市场。
"Max open orders exceeded" / 挂单数量超限
含义：账户在单个交易对或全局的未成交挂单数量已达到上限。
处理方法：取消部分不必要的挂单，腾出额度后再提交新订单。
连接与签名类错误
"Signature invalid" / 签名无效
含义：钱包签名验证失败，可能原因包括：签名时间过期、钱包切换了账户、网络异常导致签名数据不完整。
处理方法：
刷新页面，重新发起签名请求
断开钱包连接后重新连接
检查钱包当前选中的账户是否与 Hyperliquid 绑定的地址一致
使用 OneKey 钱包 时，每笔签名请求都会在设备上明确展示交易内容，便于核对签名是否被意外篡改。EIP-712 结构化签名标准（参见 EIP-712）可以让用户在签名时看到易读的人类友好格式，而非纯哈希。
"Wallet not connected" / 钱包未连接
含义：前端检测不到已连接的钱包。
处理方法：重新在页面上连接钱包。若使用 WalletConnect 连接移动端钱包，检查 WalletConnect 会话是否仍有效，参阅 WalletConnect 文档 了解重连步骤。
"Transaction rejected" / 交易被拒绝
含义：用户在钱包端手动拒绝了签名请求，或签名超时被系统取消。
处理方法：重新提交操作，在钱包弹出签名请求时及时确认。
资金相关错误
"Withdrawal amount exceeds available balance" / 提款超额
含义：申请提款的金额超过账户可用余额，或者有未结算的仓位占用了部分资金。
处理方法：检查账户中未实现盈亏和保证金占用情况，确认可提余额后重新操作。出入金机制可参考 Hyperliquid App 的余额面板。
快速排查检查表
避免频繁报错的建议
在 Hyperliquid 下单前，养成检查保证金余额和杠杆设置的习惯。
使用稳定的浏览器环境，避免签名超时。
通过 OneKey Perps 接入 Hyperliquid，OneKey 钱包签名流程清晰稳定，减少因钱包端问题导致的签名错误。
保存 Hyperliquid 官方 Discord 链接，遇到未知错误可第一时间查询官方解答。
常见问题
Q1：报错后我的资金会丢失吗？
答：通常不会。大多数错误仅表示操作未被执行，资金仍留在账户中。但如果是仓位爆仓（Liquidation）事件，则保证金可能被全部或部分扣除，这不属于报错而是正常的风控机制。
Q2：同一错误反复出现怎么办？
答：记录错误信息和操作步骤，到 Hyperliquid 官方社群描述问题，或通过 Hyperliquid App 的帮助入口联系支持。
Q3：出金时出现错误，资金会被锁定吗？
答：通常不会。出金失败意味着操作未提交或未完成，资金仍在账户内。建议等待片刻后重试，或联系官方支持。
Q4：如何区分是我的操作问题还是协议 bug？
答：可以通过查询链上数据确认该操作是否被记录。如果链上完全没有该笔操作记录，通常是客户端问题；如果链上有记录但结果异常，则可能需要向官方反馈。
Q5：MetaMask 和 OneKey 钱包哪个在 Hyperliquid 上更稳定？
答：两者均受支持。OneKey 完全开源（可在 OneKey GitHub 查看代码），签名界面透明，对于在意安全审计的用户有额外的可信度。
结论
遇到 Hyperliquid 错误信息不必慌张，绝大多数都是有明确解法的已知问题。按照本文分类对照，通常几分钟内即可恢复正常操作。
如需在安全稳定的环境下交易 Hyperliquid 永续合约，推荐通过 OneKey Perps 接入，访问 OneKey 官网 下载钱包，开始更安心的链上交易体验。
风险提示：本文内容仅供参考，不构成任何投资建议。加密资产交易具有极高风险，包括但不限于市场波动、技术故障和监管风险，请充分了解风险后再进行操作。
