Back to Details

exa-common-errors

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Exa Common Errors

Exa常见错误

Overview

概述

Quick reference for the top 10 most common Exa errors and their solutions.
本文是Exa十大常见错误及其解决方案的快速参考指南。

Prerequisites

前提条件

  • Exa SDK installed
  • API credentials configured
  • Access to error logs
  • 已安装Exa SDK
  • 已配置API凭证
  • 可访问错误日志

Instructions

操作步骤

Step 1: Identify the Error

步骤1：识别错误

Check error message and code in your logs or console.
在日志或控制台中查看错误消息和错误代码。

Step 2: Find Matching Error Below

步骤2：匹配对应错误

Match your error to one of the documented cases.
将你的错误与下文记录的案例进行匹配。

Step 3: Apply Solution

步骤3：应用解决方案

Follow the solution steps for your specific error.
按照对应错误的解决方案步骤操作。

Output

输出结果

  • Identified error cause
  • Applied fix
  • Verified resolution
  • 已识别的错误原因
  • 已应用的修复方案
  • 已验证的解决结果

Error Handling

错误处理

Authentication Failed

认证失败

Error Message:
Authentication error: Invalid API key
Cause: API key is missing, expired, or invalid.
Solution:
bash
undefined
错误消息：
Authentication error: Invalid API key
原因： API密钥缺失、过期或无效。
解决方案：
bash
undefined

Verify API key is set

验证API密钥是否已设置

echo $EXA_API_KEY

---
echo $EXA_API_KEY

---

Rate Limit Exceeded

超出速率限制

Error Message:
Rate limit exceeded. Please retry after X seconds.
Cause: Too many requests in a short period.
Solution: Implement exponential backoff. See 
exa-rate-limits
skill.
错误消息：
Rate limit exceeded. Please retry after X seconds.
原因： 短时间内发送了过多请求。
解决方案： 实现指数退避机制。请查看
exa-rate-limits
技能。

Network Timeout

网络超时

Error Message:
Request timeout after 30000ms
Cause: Network connectivity or server latency issues.
Solution:
typescript
// Increase timeout
const client = new Client({ timeout: 60000 });
错误消息：
Request timeout after 30000ms
原因： 网络连接问题或服务器延迟。
解决方案：
typescript
// 增加超时时间
const client = new Client({ timeout: 60000 });

Examples

示例

Quick Diagnostic Commands

快速诊断命令

bash
undefined
bash
undefined

Check Exa status

检查Exa状态

curl -s https://status.exa.com
curl -s https://status.exa.com

Verify API connectivity

验证API连通性

curl -I https://api.exa.com
curl -I https://api.exa.com

Check local configuration

检查本地配置

env | grep EXA
undefined
env | grep EXA
undefined

Escalation Path

升级处理流程

  1. Collect evidence with 
    exa-debug-bundle
  2. Check Exa status page
  3. Contact support with request ID
  1. 使用
    exa-debug-bundle
    收集证据
  2. 查看Exa状态页面
  3. 携带请求ID联系支持团队

Resources

参考资源

Next Steps

后续步骤

For comprehensive debugging, see 
exa-debug-bundle
.
如需全面调试，请查看
exa-debug-bundle
。