接入与开发常见错误

先确认入口与响应类别

状态	排查方向
400	参数或 JSON 不合法、模型未获准、协议不匹配、重复查询参数或非法增强模式。
401	检查自己的用户密钥、Bearer 头及是否使用正确入口；不要公开密钥。
403	请求的 Origin 或 Host 不在允许范围，不应通过禁用安全校验绕过。
404 / 405	检查路径与方法；MCP 只接收 POST，Chat Completions 不是支持的端点。
413	请求过大；统一研究查询体有 64 KiB 限制，其他请求也有独立限制。
429	达到入口容量限制；控制并发与重试，不把失败请求无限重放。
502 / 504	上游返回异常、非 API 内容或超时；提供脱敏状态和请求编号。
503	相应研究或模型上游未配置，不是合法的空研究结果。

收到一段文字不代表流式完成；模型错误、断连、超时或缺少完成事件需单独处理。MCP 返回 HTTP 200 后仍应检查 error 与 isError。重试模型调用可能再次消耗额度。

编译错误先检查行号、函数签名与目标平台。编译通过但没有成交时，读取初始化与交易返回码、测试条件和过滤规则；执行失败不能解释成有效零成交。

记录时间、端点、协议、获准模型 ID、X-EA-Request-ID、状态及脱敏错误。不要公开 Authorization、上游凭据、完整私有源码、客户需求或账户信息。用量未知不应自行补零当作账单。