HTTP 状态码清单大全

HTTP 状态码清单大全

目录

• HTTP 状态码总览表
• 概述
• HTTP 状态码分类概览
• 一、1xx 信息性状态码
• 二、2xx 成功状态码
• 三、3xx 重定向状态码
• 四、4xx 客户端错误状态码
• 五、5xx 服务器错误状态码
• 状态码分类关系图
• 常见状态码速查表
• 重定向状态码对比
• 规范文档与查阅来源
• 总结与记忆技巧

HTTP 状态码总览表

下表按类别列出文档中涉及的所有 HTTP 状态码，便于快速查阅。

概述

**HTTP 状态码（Status Code）**是服务器对客户端请求的响应状态的三位数字代码，对 Web 开发和调试至关重要。状态码由三位数字组成，第一位数字定义响应的类别。

本文档整理从 1xx 到 5xx 的常用 HTTP 状态码清单，并说明规范来源与查阅方式。内容基于 IETF RFC 及常见实践整理，供开发与排查参考。

HTTP 状态码分类概览

第一位数字 → 类别含义 1xx ── 信息性：请求已接收，继续处理 2xx ── 成功：请求已成功被接收、理解并接受 3xx ── 重定向：需要客户端进一步操作才能完成请求 4xx ── 客户端错误：请求有误或无法满足（责任在客户端） 5xx ── 服务器错误：服务器处理请求时出错（责任在服务器）

一、1xx 信息性状态码 (Informational)

表示请求已被接收，需要继续处理。日常开发中较少直接使用。

典型流程（100 Continue）：

客户端 服务器 │ │ │ POST /api (Expect: 100-continue) │ Headers only ───────────────>│ │ │ │ 100 Continue │ │ <────────────────────────────│ │ │ │ Request Body ───────────────>│ │ │ │ 200 OK + Body │ │ <────────────────────────────│

二、2xx 成功状态码 (Success)

表示请求已成功完成。

常见用法对照：

三、3xx 重定向状态码 (Redirection)

表示需要客户端采取进一步操作（如跳转到新 URL）才能完成请求。

常见混淆点：

• 301 vs 302：301 永久，搜索引擎会更新索引；302 临时，一般保留原链接。
• 302 vs 307：307 明确禁止在重定向时改变请求方法（POST 仍为 POST）。
• 301 vs 308：308 明确禁止在重定向时改变请求方法。

四、4xx 客户端错误状态码 (Client Error)

表示错误来自客户端（请求有误、未认证、无权限、资源不存在等）。

401 与 403 区别：

401 Unauthorized 403 Forbidden ───────────────── ───────────────── 「你是谁？」 「我知道你是谁， 未认证 / 未登录 但你不许访问」 应返回 WWW-Authenticate 不应再提示登录

五、5xx 服务器错误状态码 (Server Error)

表示服务器在处理请求时发生错误，责任在服务端。

网关/代理场景示意：

客户端 → [Nginx/网关] → 上游应用 502：上游返回无效响应或连接失败 504：上游在规定时间内未响应

状态码分类关系图

HTTP 响应 │ ┌───────────────┼───────────────┐ │ │ │ ▼ ▼ ▼ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ 1xx │ │ 2xx │ │ 3xx │ │ 信息 │ │ 成功 │ │ 重定向 │ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ │ │ ▼ ▼ ▼ ┌─────────┐ ┌─────────┐ │ 4xx │ │ 5xx │ │ 客户端 │ │ 服务器 │ │ 错误 │ │ 错误 │ └─────────┘ └─────────┘

常见状态码速查表

开发中最常遇到的状态码可重点掌握：

重定向状态码对比

规范文档与查阅来源

HTTP 状态码的语义由IETF RFC定义，以下为常用规范与查阅途径。

核心规范文档

历史规范（了解即可）：RFC 7231（已被 RFC 9110 取代）、RFC 2616（已过时）。

查阅方式

推荐链接：

• RFC 9110（HTML）：https://www.rfc-editor.org/rfc/rfc9110.html
• IANA HTTP 状态码注册表：https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
• MDN HTTP 状态码：https://developer.mozilla.org/en-US/docs/Web/HTTP/Status

实践建议：

• 日常开发与学习：优先查MDN。
• 确认冷门状态码或官方定义：查IANA 注册表。
• 深度研究或争议问题：查RFC 9110对应章节。

总结与记忆技巧

• 2xx 开心：请求顺利，成功一类。
• 3xx 转发：要去别处找（重定向、缓存 304）。
• 4xx 你错了：检查请求（URL、参数、权限、限流等）。
• 5xx 我错了：服务器或上游有问题，需运维/开发介入。

实际开发中出现频率最高的状态码通常包括：200、301/302、304、400、401、403、404、429、500、502、503、504，建议重点掌握其含义与使用场景。

代码中设置状态码示例

Node.js (Express)：

// 成功res.status(200).json({data:result});res.status(201).location('/api/users/1').json({id:1,name:'Alice'});res.status(204).send();// 客户端错误res.status(400).json({error:'Invalid parameters'});res.status(401).set('WWW-Authenticate','Bearer').send('Unauthorized');res.status(403).json({error:'Forbidden'});res.status(404).json({error:'Not Found'});res.status(429).set('Retry-After','60').json({error:'Too Many Requests'});// 服务器错误res.status(500).json({error:'Internal Server Error'});res.status(503).json({error:'Service Unavailable'});

Python (Flask)：

fromflaskimportjsonify# 成功returnjsonify({"data":result}),200returnjsonify({"id":1}),201return'',204# 客户端错误returnjsonify({"error":"Bad Request"}),400returnjsonify({"error":"Unauthorized"}),401returnjsonify({"error":"Not Found"}),404returnjsonify({"error":"Too Many Requests"}),429# 服务器错误returnjsonify({"error":"Internal Server Error"}),500

本文档基于 IETF RFC 及公开技术资料整理，供开发与排查参考。