HTTP 状态码速查:前后端都该知道的 12 个
【摘要】 200、301、404、500 人人认识,但 204、304、422、429 经常被误用。本文按场景把最常用状态码串一遍。
200、404、500 人人都认识,但接口设计里真正容易误用的是另一批。按场景把 12 个最常用状态码串一遍,够覆盖九成接口。
一、成功类
200 万能成功;201 Created 用于新建资源成功(POST /users 返回它更语义化);204 No Content 表示成功但没有响应体,DELETE 操作的标准答案,比返回一个空 JSON 优雅得多。
二、重定向与缓存
301 永久重定向(换域名用,浏览器会缓存);302 临时跳转;304 Not Modified 配合协商缓存,是性能优化的常客——上一篇文章讲缓存时提过它的搭档 ETag。
三、客户端错误类
400 参数格式错误(缺字段、JSON 没解析开);401 未认证(没登录);403 已登录但没权限——401 和 403 别混用;404 资源不存在;422 参数格式对但业务校验不通过;429 Too Many Requests 限流,配上 Retry-After 头是标准做法。
四、服务端错误类
500 代码异常;502 网关收到无效响应(上游挂了,Nginx 日志里最常见的背锅侠);504 上游超时。看到 502/504 先查上游服务,别急着怀疑 Nginx 本身。
接口返回错误时带上统一结构的错误码和信息体,配合正确的状态码,联调效率会明显提升。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)