HTTP 状态码完全指南
HTTP 状态码(HTTP Status Code)是服务器对客户端请求返回的三位数字标识,用于告知请求的处理结果。了解状态码是 Web 开发、接口调试、渗透测试的基础技能。
一、状态码分类
| 分类 | 范围 | 含义 | 说明 |
|---|---|---|---|
| 1xx | 100-199 | 信息响应 | 请求已接收,继续处理 |
| 2xx | 200-299 | 成功 | 请求已成功处理 |
| 3xx | 300-399 | 重定向 | 需要进一步操作完成请求 |
| 4xx | 400-499 | 客户端错误 | 请求包含错误或无法处理 |
| 5xx | 500-599 | 服务器错误 | 服务器在处理请求时出错 |
MERMAID
115%
Ctrl + 滚轮缩放 · 拖动查看完整流程图
二、1xx 信息响应
| 状态码 | 名称 | 含义 | 使用场景 |
|---|---|---|---|
| 100 | Continue | 客户端应继续发送请求 | 客户端发送 Expect: 100-continue 后,服务器确认可以接收请求体 |
| 101 | Switching Protocols | 服务器同意切换协议 | WebSocket 升级(Upgrade: websocket) |
| 102 | Processing | 服务器正在处理(WebDAV) | 防止客户端超时,表示请求还在处理中 |
| 103 | Early Hints | 提前推送资源链接 | 服务器在最终响应前,提前告知浏览器需要加载的资源 |
101 切换协议示例
HTTP
# 客户端请求
GET /chat HTTP/1.1
Host: example.com
Upgrade: websocket
Connection: Upgrade
# 服务器响应
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
三、2xx 成功
| 状态码 | 名称 | 含义 | 说明 |
|---|---|---|---|
| 200 | OK | 请求成功 | 标准响应,GET 返回资源,POST 返回处理结果 |
| 201 | Created | 资源已创建 | 常用于 POST/PUT 创建资源后返回 |
| 202 | Accepted | 已接受但未处理完成 | 异步任务场景 |
| 203 | Non-Authoritative Info | 返回信息来自第三方 | 代理服务器修改了原始响应 |
| 204 | No Content | 无返回内容 | DELETE 成功,或仅需返回状态不需内容 |
| 205 | Reset Content | 重置发送方视图 | 用于表单提交成功后清空表单 |
| 206 | Partial Content | 部分内容 | 断点续传、分片下载(响应 Range 头) |
| 207 | Multi-Status | 多状态(WebDAV) | 批量操作返回多个资源的状态 |
| 208 | Already Reported | 已报告(WebDAV) | 防止同一资源重复列出 |
| 226 | IM Used | 服务器完成实例操作 | 返回当前实例操作结果 |
200 OK
HTTP
HTTP/1.1 200 OK
Content-Type: application/json
{"id": 1, "name": "张三", "email": "zhangsan@example.com"}
201 Created
HTTP
POST /api/users HTTP/1.1
Content-Type: application/json
{"name": "张三", "email": "zhangsan@example.com"}
---
HTTP/1.1 201 Created
Location: /api/users/123
Content-Type: application/json
{"id": 123, "name": "张三"}
204 No Content
HTTP
DELETE /api/users/123 HTTP/1.1
---
HTTP/1.1 204 No Content
# 无响应体
206 Partial Content(断点续传)
HTTP
GET /video.mp4 HTTP/1.1
Range: bytes=0-1023
---
HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/1048576
Content-Length: 1024
四、3xx 重定向
| 状态码 | 名称 | 含义 | 说明 |
|---|---|---|---|
| 300 | Multiple Choices | 多种选择 | 请求的资源有多个可用版本 |
| 301 | Moved Permanently | 永久重定向 | 资源被永久移动到新 URL,搜索引擎更新索引 |
| 302 | Found | 临时重定向 | 资源临时移动到新 URL,搜索引擎不更新索引 |
| 303 | See Other | 查看其他位置 | 使用 GET 方法访问新 URL(POST 后重定向) |
| 304 | Not Modified | 资源未修改 | 使用缓存(响应 If-Modified-Since / If-None-Match) |
| 305 | Use Proxy | 需使用代理访问 | 已废弃 |
| 307 | Temporary Redirect | 临时重定向 | 类似 302,但保持请求方法不变 |
| 308 | Permanent Redirect | 永久重定向 | 类似 301,但保持请求方法不变 |
301 vs 302 vs 307 vs 308
| 状态码 | 是否永久 | 是否保持请求方法 | 典型用途 |
|---|---|---|---|
| 301 | 是 | 否(可能改为 GET) | 域名变更、HTTP→HTTPS |
| 302 | 否 | 否(可能改为 GET) | 临时跳转、登录后跳转 |
| 307 | 否 | 是 | 临时跳转(需保持 POST 方法) |
| 308 | 是 | 是 | 永久跳转(需保持 POST 方法) |
HTTP
# 301 重定向(HTTP → HTTPS)
HTTP/1.1 301 Moved Permanently
Location: https://example.com/
# 302 临时重定向(登录跳转)
HTTP/1.1 302 Found
Location: /dashboard
# 304 使用缓存(客户端缓存有效)
GET /style.css HTTP/1.1
If-Modified-Since: Mon, 08 Jun 2026 10:00:00 GMT
---
HTTP/1.1 304 Not Modified
# 无响应体,浏览器使用本地缓存
重定向在渗透测试中的价值
CODE
301/302 Location 泄露:
- 看 Location 字段是否有内网 IP(如 Location: http://192.168.1.100/admin)
- 查看重定向链是否可绕过鉴权
304 Not Modified:
- 可用于探测资源是否存在
- 配合 If-Modified-Since 判断文件更新时间
五、4xx 客户端错误
| 状态码 | 名称 | 含义 | 说明 |
|---|---|---|---|
| 400 | Bad Request | 请求格式错误 | 参数错误、JSON 格式错误等 |
| 401 | Unauthorized | 未认证 | 需要登录或 Token 无效 |
| 402 | Payment Required | 需要付费 | 预留,极少使用 |
| 403 | Forbidden | 禁止访问 | 已认证但无权限 |
| 404 | Not Found | 资源不存在 | 路径错误或文件不存在 |
| 405 | Method Not Allowed | 请求方法不允许 | GET/POST/PUT/DELETE 方法不支持 |
| 406 | Not Acceptable | 无法满足 Accept 头 | 服务器无法生成客户端期望的格式 |
| 407 | Proxy Auth Required | 需代理认证 | 同 401 但针对代理 |
| 408 | Request Timeout | 请求超时 | 客户端在指定时间内未发送完整请求 |
| 409 | Conflict | 资源冲突 | 版本冲突、资源已存在 |
| 410 | Gone | 资源已永久删除 | 类似 404,但明确表示资源已不存在 |
| 411 | Length Required | 需要 Content-Length | 未提供 Content-Length 头 |
| 412 | Precondition Failed | 前置条件不满足 | If-Match/If-None-Match 检验失败 |
| 413 | Payload Too Large | 请求体过大 | 上传文件超限 |
| 414 | URI Too Long | URL 过长 | GET 请求 URL 超出长度限制 |
| 415 | Unsupported Media Type | 不支持的媒体类型 | Content-Type 不被接受 |
| 416 | Range Not Satisfiable | Range 头不合法 | 请求的 Range 超出文件大小 |
| 417 | Expectation Failed | Expect 头不被支持 | Expect: 100-continue 不被支持 |
| 418 | I’m a Teapot | 我是茶壶 | 愚人节玩笑(HTCPCP 协议) |
| 421 | Misdirected Request | 请求被错误定向 | 请求发送到了无法处理的服务器 |
| 422 | Unprocessable Entity | 语义错误 | 请求格式正确但语义错误(如校验失败) |
| 423 | Locked | 资源被锁定 | WebDAV 资源锁定 |
| 424 | Failed Dependency | 依赖失败 | 前置操作失败 |
| 425 | Too Early | 请求过早 | 服务器不愿处理可能重放的请求 |
| 426 | Upgrade Required | 需升级协议 | 需使用 TLS/1.3 等新协议 |
| 428 | Precondition Required | 需发条件请求 | 缺少 If-Match 等条件头 |
| 429 | Too Many Requests | 请求过多 | 触发限流(Rate Limiting) |
| 431 | Header Fields Too Large | 请求头过大 | 单头或总头大小超限 |
| 451 | Unavailable For Legal Reasons | 法律原因不可用 | 被审查或屏蔽的内容 |
401 vs 403 关键区别
HTTP
# 401 Unauthorized — 未登录或 Token 无效
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="api"
# 可尝试:登录获取 Token 后再请求
# 403 Forbidden — 已登录但权限不足
HTTP/1.1 403 Forbidden
# 可尝试:提权、越权测试、参数篡改
429 限流
HTTP
# 请求太频繁被限流
HTTP/1.1 429 Too Many Requests
Retry-After: 60
# 响应头 Retry-After 指示多久后可以重试
405 Method Not Allowed
HTTP
# 接口只支持 POST,但发了 GET
GET /api/users HTTP/1.1
---
HTTP/1.1 405 Method Not Allowed
Allow: POST, OPTIONS
# Allow 头显示支持的 HTTP 方法
渗透测试中的 4xx 利用
BASH
# 403 绕过技术
# 1. 添加 URL 后缀
# 403 /admin → /admin/ → 200
# 403 /admin → /admin?. → 200
# 403 /admin → /;foo/admin → 200
# 2. HTTP 方法篡改
# GET /admin → 403
# POST /admin → 200 (方法混淆漏洞)
# 3. 头信息注入
# X-Original-URL: /admin
# X-Rewrite-URL: /admin
# X-Forwarded-For: 127.0.0.1
# 4. 403 信息泄露
# 403 页面可能包含服务器版本、绝对路径
# 403 响应体可能包含"Contact admin@example.com"等邮箱信息
# 401 爆破
# 401 Basic Auth 可直接爆破
hydra -L users.txt -P pass.txt target.com http-get /admin
# 404 信息收集
# 404 页面可能暴露 Web 服务器版本、后端语言
# 404 与 403 的区别可用于判断目录是否存在(403=存在但无权限)
六、5xx 服务器错误
| 状态码 | 名称 | 含义 | 说明 |
|---|---|---|---|
| 500 | Internal Server Error | 服务器内部错误 | 通用错误,未捕获的异常 |
| 501 | Not Implemented | 未实现 | 服务器不支持此功能 |
| 502 | Bad Gateway | 网关错误 | 上游服务器无响应或返回错误 |
| 503 | Service Unavailable | 服务不可用 | 服务器过载或维护中 |
| 504 | Gateway Timeout | 网关超时 | 上游服务器超时未响应 |
| 505 | HTTP Version Not Supported | HTTP 版本不支持 | |
| 506 | Variant Also Negotiates | 内部配置错误 | 透明内容协商错误 |
| 507 | Insufficient Storage | 存储空间不足 | WebDAV |
| 508 | Loop Detected | 检测到循环 | 无限重定向 |
| 510 | Not Extended | 扩展未实现 | 需要的扩展不在支持列表中 |
| 511 | Network Auth Required | 需网络认证 | 连接 WiFi 门户时的重定向 |
500 错误的信息泄露风险
HTTP
# 生产环境不应暴露的错误信息
HTTP/1.1 500 Internal Server Error
# ❌ 危险:暴露了完整路径和代码
Warning: include_once(/var/www/html/config.php): failed to open stream
# ❌ 危险:暴露了 SQL 语句
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'test.users' doesn't exist
# ✅ 安全的做法
HTTP/1.1 500 Internal Server Error
Content-Type: application/json
{"error": "internal_error", "message": "服务器内部错误"}
502/503/504 区别
MERMAID
115%
Ctrl + 滚轮缩放 · 拖动查看完整流程图
渗透测试中的 5xx 利用
CODE
5xx 的价值:
1. 500/502/504 表明后端服务存在
2. 500 错误信息可能泄露源码路径、数据库结构
3. 触发 500 的参数 → 可能存在注入点
4. 503/429 可判断存在限流或 WAF
5. 对比 500 和 200 的参数差异 → 找到漏洞触发条件
七、状态码在渗透测试中的应用
7.1 信息收集阶段
BASH
# 目录/文件枚举——通过状态码判断资源是否存在
# 200 = 存在且可访问
# 301/302 = 存在,有重定向
# 401/403 = 存在,但需要认证或权限不足
# 404 = 不存在
# 500 = 可能存在(服务器报错)
# 使用 ffuf 进行目录爆破(通过状态码过滤)
ffuf -u http://target.com/FUZZ -w wordlist.txt -mc 200,301,401,403
# 排除 404
ffuf -u http://target.com/FUZZ -w wordlist.txt -fc 404
# 只看服务器错误的路径(可能泄露信息)
ffuf -u http://target.com/FUZZ -w wordlist.txt -mc 500
7.2 状态码与漏洞检测
| 测试场景 | 期望状态码 | 异常状态码 | 说明 |
|---|---|---|---|
| 未登录访问后台 | 401/302 | 200 | 存在越权 |
| 普通用户访问管理员接口 | 403 | 200 | 存在水平/垂直越权 |
| SQL 注入测试 | 200/500 | 500 | 500 表示可能触发异常 |
| 文件上传 | 201/200 | 403 | 403 表示被 WAF 拦截 |
| 参数篡改 | 400/422 | 200 | 后端未校验参数 |
| IDOR 测试 | 403 | 200 | 可越权访问其他用户数据 |
7.3 常见状态码含义速查表
| 状态码 | 渗透测试含义 |
|---|---|
| 200 | 存在且有权限访问 |
| 201 | 创建成功(可能越权创建资源) |
| 301/302 | 存在重定向,Location 可能泄露信息 |
| 304 | 资源存在(可用于对比确认文件) |
| 400 | 参数格式不对(可能有参数校验) |
| 401 | 需要认证(可尝试爆破/绕过) |
| 403 | 存在但无权访问(可尝试绕过技巧) |
| 404 | 不存在(但自定义 404 页面可能不同) |
| 405 | 存在,但 HTTP 方法不对(查看 Allow 头) |
| 429 | 触发限流(需降低速率或换 IP) |
| 500 | 存在且触发异常(可能泄露信息) |
| 502/504 | 上游服务有问题(可能架构信息) |
| 503 | 服务器过载或维护中 |
7.4 状态码绕过 WAF 技巧
BASH
# WAF 通常对特定状态码有不同拦截策略
# 技巧 1:利用 302 绕过
# WAF 拦截 /admin,但可能不拦截重定向后的请求
curl -L -b "admin_session=test" http://target.com/login
# 技巧 2:利用 405 方法绕过
# WAF 可能只检查 GET,不检查 OPTIONS
curl -X OPTIONS http://target.com/admin
# 技巧 3:利用 401 绕过
# 部分 WAF 对 401 页面不检查
curl -u admin:wrong http://target.com/sql-inject?q=1' OR '1'='1
# 技巧 4:利用 206 分片绕过
# 用 Range 头分片请求,绕过基于内容匹配的 WAF
curl -H "Range: bytes=0-500" http://target.com/api/data
八、RESTful API 状态码最佳实践
| 场景 | HTTP 方法 | 成功 | 客户端错误 | 服务器错误 |
|---|---|---|---|---|
| 获取资源 | GET | 200 | 404(不存在) / 401(未登录) | 500 |
| 创建资源 | POST | 201 | 400(参数错) / 409(已存在) | 500 |
| 更新资源 | PUT | 200 | 404 / 400 / 409(冲突) | 500 |
| 部分更新 | PATCH | 200 | 400 / 422(语义错) | 500 |
| 删除资源 | DELETE | 204 | 404 / 401 | 500 |
PYTHON
from flask import Flask, jsonify, request
app = Flask(__name__)
# 正确的状态码使用示例
@app.route('/api/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
user = find_user(user_id)
if not user:
# 资源不存在 → 404
return jsonify({"error": "user_not_found"}), 404
return jsonify(user), 200
@app.route('/api/users', methods=['POST'])
def create_user():
data = request.get_json()
if not data or 'name' not in data:
# 参数错误 → 400
return jsonify({"error": "name_required"}), 400
if user_exists(data['email']):
# 资源冲突 → 409
return jsonify({"error": "email_exists"}), 409
user = create_user(data)
# 创建成功 → 201
return jsonify(user), 201
@app.route('/api/users/<int:user_id>', methods=['DELETE'])
def delete_user(user_id):
if not has_permission(request.user, user_id):
# 有资源但无权限 → 403
return jsonify({"error": "forbidden"}), 403
delete_user_by_id(user_id)
# 删除成功无内容 → 204
return '', 204
九、总结
MERMAID
115%
Ctrl + 滚轮缩放 · 拖动查看完整流程图
| 场景 | 最关键的状态码 |
|---|---|
| 开发调试 | 200 / 400 / 500 |
| API 设计 | 201 / 204 / 422 / 409 |
| 渗透测试 | 200 / 403 / 401 / 500 / 302 |
| 性能排查 | 502 / 504 / 429 |
| 安全运维 | 403 / 429 / 500 / 511 |