HTTP 状态码速查:前后端都该知道的 12 个

举报
yd_213494201 发表于 2026/11/09 03:05:21 2026/11/09
【摘要】 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。