← Retour aux guides

API 请求报错 401/402/429/5xx？这样排查最快

先别急着重试：先判断错误属于哪一类

调试 API 失败请求，最常见的坑就是“看到报错就狂点重试”。正确顺序应该是先看状态码，再看响应体里的 error message。401、402、429、5xx分别代表鉴权、计费、限流和服务端异常，处理方式完全不同。把它们混在一起，只会让日志更乱、成本更高。

如果你接的是 AI 接口，建议先固定一个最小请求：只保留最短 prompt、最基础参数、单线程调用，并把原始请求与响应完整记录下来。这样才能快速判断问题是在代码、账号、额度，还是上游服务。

401：不是“接口挂了”，而是你的身份没通过

401 通常来自API Key 错误、Header 格式错误、环境变量没加载，或者把测试 ключ/正式 ключ 混用了。很多人会忽略一个细节：有些 SDK 虽然能发出请求，但如果 base URL、项目权限或 key 前缀不对，返回的仍然是 401。

• 检查 Authorization 是否写成 Bearer 你的密钥，不要多空格、不要漏前缀。
• 确认程序读取的是当前环境的变量，不是旧的本地缓存。
• 用 curl 或 Postman 复现一次，排除 SDK 封装层的问题。
• 确认账号、项目、组织权限都允许访问对应模型。

如果你用的是 Claude Code、Codex 或任何 OpenAI SDK，59API 都可以直接接入，base URL 只需要改成 https://api.59api.com。这类统一入口能减少“不同平台密钥混用”导致的 401 问题。

402：多数不是代码错，而是余额或计费状态异常

402 一般意味着账户余额不足、套餐未生效、调用配额已耗尽，或者你的请求触发了额外计费规则。很多团队排查时会反复改代码，最后才发现只是账号没钱了。

• 先看控制台余额和当日用量，不要只看“是否已开通”。
• 检查是否存在模型级别的单独限额，尤其是高成本模型。
• 确认自动充值、预警邮件或 webhook 是否正常。
• 在压测前设置预算上限，避免一次测试把额度打光。

如果你想把调试成本压到更低，59API 的按量付费会更适合：只为真实调用付费，不用先买大包月，适合排障、测试和小流量生产环境。它还提供推荐返利，适合长期使用时降低综合成本。

429：限流不是故障，往往是你发太快了

429 的本质是请求超过了速率限制。常见坑包括：并发数开太高、重试没有退避、定时任务同一秒集中启动、多个服务共用一个 key 却没有做全局限流。

• 给客户端加指数退避 + 随机抖动，不要固定 1 秒重试。
• 把突发流量改成队列处理，控制并发而不是盲目堆机器。
• 查看响应头中的速率限制信息，若有剩余额度就按窗口调度。
• 对非紧急请求做缓存，避免重复问同一个问题。

对于 AI 场景，429 往往出现在批量生成、自动化工作流和 Agent 循环里。59API 支持主流 OpenAI SDK 与相关工具链，适合在现有项目里直接加限流策略，不必为了测试新模型再重写一套接入逻辑。

5xx：先怀疑上游，再怀疑自己的参数

5xx 代表服务端异常，但不等于“完全不是你的问题”。很多时候是请求体过大、超时设置不合理、模型参数异常，或者上游临时故障导致的间歇性失败。

• 先重放同一请求：如果偶发，优先按临时故障处理。
• 缩短 prompt、减少上下文，排除超长输入带来的超时。
• 对写操作加幂等键或去重逻辑，避免重复扣费/重复提交。
• 对不同模型分别测试，确认是否只影响某一条模型线路。

59API 使用的是原生官方质量模型，没有降级替换，遇到问题时更容易判断是请求本身还是上游波动。调试时先用最小参数验证，再逐步加回系统提示、工具调用和长上下文，定位会快很多。

一个最实用的排查顺序

建议按这个顺序处理：401 查密钥，402 查余额，429 查限流，5xx 查重试和上游状态。同时把请求 ID、时间戳、模型名、响应体和重试次数记进日志，后面复盘才有证据链。只要你把错误分层，API 调试就不会靠“玄学重试”解决。

如果你正在做 Claude 或 GPT 的集成测试，想用更低成本把这些坑逐个跑通，可以先注册 59API 试用。它兼容常见工具链、价格低、按量结算，还带推荐返利，特别适合把调试成本控制在可接受范围内。

Tarifs · Docs