常见问题
401 和 403 有什么区别?
401 是「不知道你是谁」,没登录、token 过期、签名不对;403 是「知道你是谁,但你没有这个权限」。所以 401 应该引导重新登录,403 只能提示权限不足。两者混用时排查方向会完全跑偏。
502 和 504 该怎么排查?
两者都是网关(nginx)和上游服务之间的问题。502 是网关拿到无效响应,说明后端可能根本没启动、端口没监听、返回了非 HTTP 内容;504 是网关等上游超时,说明后端活着但处理太慢。先用 curl 内网直连后端端口确认服务是否存活,再看慢查询或第三方接口耗时。
304 是错误吗?
不是,304 表示资源没有变化,让客户端继续用本地缓存。如果你改了文件页面却没更新,先在浏览器开发者工具里看这个请求是不是 304,多半是 CDN 或浏览器缓存导致的。
429 被限流后该怎么办?
看响应头里的 Retry-After,按它等待后再重试,并做指数退避。共享 IP 时可能被同 IP 的其他调用牵连。作为接口方,限流要给出明确额度和配额说明,否则用户只会觉得服务不稳定。