API报错了怎么办？我是这样扛过来的

这周有个小伙伴私信我，说他的的页面好像"坏了"，弹出来一串英文错误码，他截图发过来——429。

我当时第一反应想不起来429是啥意思，而是想：是不是他改配置参数改出问题了？

不过一会儿后就想起来了，这是限流了。

这才松了口气。

但说真的，我第一次看到429的时候，真的以为是什么神秘代码。后来报错报多了，加上看着小伙伴们问，我慢慢就搞明白了。今天把这些整理出来，给跟我一样不太懂技术的朋友参考一下。

429——你太快了，它跟不上

429是我遇到最多的报错，没有之一。

后来看了很多技术文章才知道，429在所有API错误里占了六成以上。所以你碰到429，别慌，你不是一个人。

但429不是只有一个意思，它其实有三种不同的"你太快了"：

第一种：每分钟请求太多了。 比如你一分钟调了500次，平台上限是500次，超了就429。这种最好理解，就是次数多了。

第二种：每分钟Token太多了。 这个比较隐蔽。你可能一分钟只调了20次，次数远远没到上限，但每次请求都塞了几万Token进去，总量超了。也429。我之前完全不知道还有这种限法，直到有一次明明请求不多还是被限了，技术同事说是TPM超了，我：T什么呀？

第三种：同时并发太多了。 这个更隐蔽。你一分钟可能就发了几个请求，次数没超，Token也没超，但几个请求同时发出去，有些并发限制默认只有5个，第6个就429。

所以429看起来是一个错误码，实际上背后至少三种原因。搞清楚是哪种，才知道该怎么处理。

有个重要的事就是，429之后别立刻重试！

群里有个经典案例——有人429了之后0秒重试，又429，又重试，越搞越快，最后Key直接被封了24小时。搞技术的朋友跟我说这叫"重试风暴"。我理解的就是：你被门挡了一下，然后疯狂撞门，门就把你锁外面了。

500——它的问题，不是你的

500比429好理解：服务器崩了，不是你调用有问题。

我第一次遇到500的时候，翻来覆去检查自己的配置，折腾了半小时。后来才知道是它那边挂了，等一会儿就好。

真的等了一会儿就好了。

不过500也有几种情况：

偶尔出现： 服务器小波动，等几秒再试就行，不是大问题。

大面积出现： 可能是平台在做维护或者出了故障。这种时候去官方状态页看看，或者去社群里看看别人是不是也遇到了。如果大家都在报，那就不是你的问题，等着就行。

一直出现： 这个就要警惕了。有可能是你的请求本身有问题，触发了服务端异常。比如塞了特别长的Prompt，或者格式不对。这种最好让技术社群的朋友或者小伙伴看一下返回的具体错误信息。

我个人的经验：遇到500，先等5分钟。5分钟后还500，去群里问一声。群里如果大家都500，那就安心等着。如果只有你一直500，截图找找大神帮忙。

超时——它还在想，但你觉得它死了

超时这个问题比较尴尬。

因为吧，它在思考，深度推理模型就是需要更长时间。

这就很尴尬了。你说它慢吧，它确实慢。但它是在干活，不是在摸鱼。

不过超时和"慢"还不完全是一回事。超时是你设了一个时间限制，比如30秒，AI如果30秒还没回完，就自动断了。这个时间限制是可以调的。

这里还有个坑：如果你用的是对话模式，聊天越长，AI需要处理的上下文越多，回复时间也越长。聊到20轮以上，超时的概率会明显增加。这个我之前第三篇文章提过，聊天越久越贵，也会越慢。

所以如果经常超时，可以试试：

• 把超时时间调长一点
• 长对话开个新的
• Prompt精简一点，塞的东西越少，处理越快

401——钥匙不对，门打不开

401和403都是认证问题，我之前也犯过。

最经典的一次：我把测试环境的Key用到了生产环境。测试Key有额度限制，生产环境流量一大，直接401。全报错，我找半天才发现是Key用错了。

还有一种常见情况：Key过期了。有些平台Key有有效期，过期了就401。我之前有个Key用了三个月，突然某天全部401，搞了半天才发现是过期了，重新生成一个就好了。

401排查起来其实最简单：先确认Key是不是对的，再确认Key是不是还有效。

我现在的排查流程

作为一个不太懂代码的人，我的排查流程特别简单：

1. 截图错误码
2. 看一眼是429、500、超时还是401
3. 429→等一会儿再试，别疯狂重试
4. 500→等5分钟，还报错就去查资料问
5. 超时→调长超时时间，精简Prompt
6. 401→检查Key是不是对的、有没有过期
7. 以上都不行→截图发进社群“吐槽”或寻求大家帮助

就这几步。没什么高深的，但确实够用了。

日常遇到，别慌，别疯狂重试，别自己吓自己。

说到底，这些不可怕，可怕的是不知道报的是什么错。搞清楚心里就有底了。
如果你还踩过其他坑，欢迎评论区交流你的排查经验。
今天就到这。

再说吧～

🔑