《HTTP 状态码入门:200、404、500 到底在说什么》

举报
yd_243701064 发表于 2026/11/17 06:29:23 2026/11/17
【摘要】 调接口、打开网页、传一个文件,服务器每次都会回一个三位数字,这就是 HTTP 状态码。它不是报错代码,而是一句简短的回答:成功了、去别处找、你传错了、还是我这边出了问题。看懂首位数字,就读懂了一大半。一、先看首位:五大类1xx:信息性,请求已收到、正在处理,平时很少直接见到2xx:成功,请求被正确处理3xx:重定向,东西不在这里了、去另一个地址找4xx:客户端错误,请求本身有问题5xx:服务...

调接口、打开网页、传一个文件,服务器每次都会回一个三位数字,这就是 HTTP 状态码。它不是报错代码,而是一句简短的回答:成功了、去别处找、你传错了、还是我这边出了问题。看懂首位数字,就读懂了一大半。

一、先看首位:五大类

1xx:信息性,请求已收到、正在处理,平时很少直接见到
2xx:成功,请求被正确处理
3xx:重定向,东西不在这里了、去另一个地址找
4xx:客户端错误,请求本身有问题
5xx:服务器错误,请求没问题、是服务器那边出了状况

记住这个分法,看到一个没见过的码,先看首位就能大致定位:是该改自己的请求,还是该等服务器恢复。

二、最常见的几个码

200 OK:最常见的好消息,请求成功、数据正常返回
201 Created:新建成功,比如提交表单后真的建出了一条新记录
204 No Content:成功、但没有内容可返回,比如删除操作成功后什么都不用回
301 Moved Permanently:永久搬家,以后都去新地址
302 Found:临时换地方,这次去新地址、下次还可能回来
304 Not Modified:没变过、用你本地缓存的那份就行,省一次传输
400 Bad Request:请求写错了,比如参数缺了、格式不对
401 Unauthorized:没登录、或者登录凭证过期了,先登录再试
403 Forbidden:登了、但没权限,这个资源不归你看
404 Not Found:地址错了、或者东西被删了,服务器上没有这个资源
429 Too Many Requests:请求太频繁了,先慢下来、过一会儿再试
500 Internal Server Error:服务器内部出错了,不是你的请求问题
502 Bad Gateway:网关收到了一个无效的响应,常出现在反向代理后面
503 Service Unavailable:服务器暂时过载或在维护,稍后再试

三、动手看一次:用 curl 读状态码

发请求时加上 -i,响应头第一行就是状态码:curl -i 请求地址。返回的第一行类似 HTTP/1.1 200 OK,前面是协议版本,后面是状态码和一句话解释。只想看状态码、不想看正文,可以用 -o /dev/null -s -w “%{http_code}”,输出就只有一个数字。

调试时先看这个数字:2xx 说明通路没问题,再去查返回的数据对不对;4xx 先检查自己的地址、参数和登录状态;5xx 先别改代码,等一等、或者看看服务器日志。

四、三个易错点

200 不等于业务成功:有些接口出错也返回 200,真正的成败写在返回体里的字段中,读接口文档时要同时看状态码和返回体。
401 和 403 别混用:401 是没认出你是谁,403 是认出你了、但不让你进,前者补登录、后者找权限。
404 不一定是地址写错:资源被删、权限导致不可见、路由没配好,都会表现为 404,先确认资源还在不在,再检查地址。

五、小结

状态码就是服务器给你的第一句话:首位数字定大类,常见码记十几个就够日常调试用。下次接口不通,先看状态码,再决定是改请求、补登录,还是等服务器恢复——比盯着报错全文猜要快得多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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