HTTP(超文本传输协议)

HTTP是以请求和响应语义为核心的应用层协议;方法、目标、字段、状态与内容共同表达一次交互。HTTP/1.1、HTTP/2和HTTP/3保留相关语义,但报文编码与传输方式不同。

二稿核验说明(2026-10-15):本文为“河洛序”教程二稿,已按官方规范与文档修订。旧实验日志单独标为“一稿留存输出”,不代表本次在Windows上的复跑;本次环境与结果见本批核验记录。示例中的“星河笔记”、账号、订单、价格与政策均为虚构教学数据。

一句话定义

HTTP是以请求和响应语义为核心的应用层协议;方法、目标、字段、状态与内容共同表达一次交互。HTTP/1.1、HTTP/2和HTTP/3保留相关语义,但报文编码与传输方式不同。

为什么重要

  • 这些Web框架处理HTTP交互,并提供路由、数据处理和渲染等应用能力;看懂报文,才能排查 401、413、429、502、504 这些报错。
  • LLM API 的流式输出、限流(429 + Retry-After)、超时都体现在 HTTP 层。
  • 缓存(ETag、Cache-Control)、压缩、长连接决定了服务的性能与成本。

原理 / 图解

HTTP 语义:RFC 9110 https://www.rfc-editor.org/rfc/rfc9110;HTTP/1.1 报文格式:RFC 9112 https://www.rfc-editor.org/rfc/rfc9112;HTTP/2:RFC 9113;HTTP/3:RFC 9114;MDN 中文教程:https://developer.mozilla.org/zh-CN/docs/Web/HTTP

图 1
状态码类别 含义 常见例子
2xx 成功 请求被处理 200 OK、201 Created、204 No Content
3xx 重定向/缓存 去别处取或用缓存 301、302、304 Not Modified
4xx 客户端错误 请求有问题 400、401 未认证、403 无权限、404、409 冲突、422 校验失败、429 太多请求
5xx 服务端错误 服务器出问题 500、501 未实现、502 网关错误、503 不可用、504 网关超时
版本 传输 关键变化
HTTP/1.1 TCP,文本报文 长连接、分块传输
HTTP/2 TCP,二进制帧 一条连接多路复用、头部压缩
HTTP/3 QUIC(基于 UDP) 减少队头阻塞、连接迁移

适用边界与核验要点

文本请求行与chunked是本例HTTP/1.1的表示,HTTP/2和HTTP/3使用帧,不能直接套用。HTTP/3运行在QUIC上,TLS也是其安全机制的一部分。TCP的recv边界不是HTTP报文或SSE事件边界;客户端必须按长度、分块或协议规定的结束条件循环读取。GET的“安全”指客户端请求的语义不应改变业务状态,并非服务器不能记访问日志。重试还需考虑幂等性、服务端约定、总预算和重试风暴。

本次检索核对的主要依据(2026-10-15):

可运行示例

Python标准库服务器仅监听回环地址。二稿客户端按响应头、Content-Length或chunked边界循环读取,展示HTTP/1.1原始字节;它不是覆盖所有HTTP语义的通用客户端。

# 文件:examples/09_http.py
"""用原始 socket 看清 HTTP/1.1 报文:请求行、头部、状态码、长连接、条件请求、分块传输。"""
import socket, threading, hashlib, time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

DOC = "星河笔记帮助:7 天内可无理由退款。\n".encode()
ETAG = '"' + hashlib.sha256(DOC).hexdigest()[:16] + '"'
class H(BaseHTTPRequestHandler):
    protocol_version = "HTTP/1.1"                # 支持长连接
    def log_message(self, *a): pass
    def do_GET(self):
        if self.path == "/help":
            if self.headers.get("If-None-Match") == ETAG:          # 条件请求:内容没变
                self.send_response(304); self.send_header("ETag", ETAG); self.end_headers(); return
            self.send_response(200)
            self.send_header("Content-Type", "text/plain; charset=utf-8")
            self.send_header("Content-Length", str(len(DOC))); self.send_header("ETag", ETAG)
            self.end_headers(); self.wfile.write(DOC)
        elif self.path == "/stream":                                  # 分块传输:边生成边发送
            self.send_response(200); self.send_header("Content-Type", "text/plain; charset=utf-8")
            self.send_header("Transfer-Encoding", "chunked"); self.end_headers()
            for tok in ["你好", ",", "我是", "客服"]:
                b = tok.encode(); self.wfile.write(f"{len(b):x}\r\n".encode() + b + b"\r\n"); self.wfile.flush(); time.sleep(0.05)
            self.wfile.write(b"0\r\n\r\n")
        else:
            body = b'{"error":"not found"}'
            self.send_response(404); self.send_header("Content-Type", "application/json")
            self.send_header("Content-Length", str(len(body))); self.end_headers(); self.wfile.write(body)

srv = ThreadingHTTPServer(("127.0.0.1", 0), H); port = srv.server_address[1]
threading.Thread(target=srv.serve_forever, daemon=True).start()

def show(raw: bytes, label):
    head, _, body = raw.partition(b"\r\n\r\n")
    print(f"--- {label}"); print(head.decode().replace("\r\n", "\n"))
    if body: print("[body]", body)

s = socket.create_connection(("127.0.0.1", port)); s.settimeout(2)
pending = bytearray()
def take_until(marker):
    while marker not in pending:
        part = s.recv(4096)
        if not part: raise EOFError("响应在边界之前断开")
        pending.extend(part)
    end = pending.index(marker) + len(marker)
    result = bytes(pending[:end]); del pending[:end]
    return result
def take_n(n):
    while len(pending) < n:
        part = s.recv(4096)
        if not part: raise EOFError("响应正文不完整")
        pending.extend(part)
    result = bytes(pending[:n]); del pending[:n]
    return result
def receive_response():
    head = take_until(b"\r\n\r\n")
    lines = head.decode("iso-8859-1").split("\r\n")
    status = int(lines[0].split()[1])
    headers = dict((k.lower(), v.strip()) for k, v in (line.split(":", 1) for line in lines[1:] if line))
    body = b""
    if status in (204, 304) or 100 <= status < 200: return head
    if headers.get("transfer-encoding", "").lower() == "chunked":
        while True:
            size_line = take_until(b"\r\n"); body += size_line
            size = int(size_line.split(b";", 1)[0], 16)
            if size == 0:
                while True:
                    trailer = take_until(b"\r\n"); body += trailer
                    if trailer == b"\r\n": return head + body
            block = take_n(size + 2)
            if not block.endswith(b"\r\n"): raise ValueError("无效 chunk 结束符")
            body += block
    if "content-length" not in headers: raise ValueError("本教学客户端只处理已知长度或 chunked 响应")
    return head + take_n(int(headers["content-length"]))
def send(req: str, label):
    s.sendall(req.encode()); data = receive_response(); show(data, label); return data

print("① 请求报文就是几行文本:")
req = f"GET /help HTTP/1.1\r\nHost: 127.0.0.1:{port}\r\nUser-Agent: k6-demo\r\nAccept: text/plain\r\n\r\n"
print(repr(req))
r1 = send(req, "② 响应 200(注意 Content-Length 按字节计)")
print("中文正文字符数", len(DOC.decode()), ",字节数", len(DOC))
send(f"GET /help HTTP/1.1\r\nHost: x\r\nIf-None-Match: {ETAG}\r\n\r\n", "③ 同一 TCP 连接上的第二个请求:带 If-None-Match → 304,无正文")
send("GET /nope HTTP/1.1\r\nHost: x\r\n\r\n", "④ 不存在的路径 → 404")
s.sendall(b"GET /stream HTTP/1.1\r\nHost: x\r\n\r\n")
t0 = time.perf_counter()
buf = receive_response()
show(buf, "⑤ 分块传输(本客户端按 HTTP 边界读取,而非假设一次 recv 收全)")
print("完整流接收耗时(ms,非逐块到达时刻):", round((time.perf_counter() - t0) * 1000))
s.sendall(b"BREW /coffee HTTP/1.1\r\nHost: x\r\n\r\n")
print("--- ⑥ 未实现的方法\n" + receive_response().decode().split("\r\n")[0])
s.close(); srv.shutdown(); srv.server_close()

一稿留存输出

以下日志按一稿保留,来自一稿声称的原环境;不是本次复跑结果。二稿代码改动后可产生不同输出,实际复跑状态以本批核验记录为准。

① 请求报文就是几行文本:
'GET /help HTTP/1.1\r\nHost: 127.0.0.1:34691\r\nUser-Agent: k6-demo\r\nAccept: text/plain\r\n\r\n'
--- ② 响应 200(注意 Content-Length 按字节计)
HTTP/1.1 200 OK
Server: BaseHTTP/0.6 Python/3.12.15
Date: Wed, 14 Oct 2026 13:43:33 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 51
ETag: "76b90d86b0742cc0"
[body] b'\xe6\x98\x9f\xe6\xb2\xb3\xe7\xac\x94\xe8\xae\xb0\xe5\xb8\xae\xe5\x8a\xa9\xef\xbc\x9a7 \xe5\xa4\xa9\xe5\x86\x85\xe5\x8f\xaf\xe6\x97\xa0\xe7\x90\x86\xe7\x94\xb1\xe9\x80\x80\xe6\xac\xbe\xe3\x80\x82\n'
中文正文字符数 19 ,字节数 51
--- ③ 同一 TCP 连接上的第二个请求:带 If-None-Match → 304,无正文
HTTP/1.1 304 Not Modified
Server: BaseHTTP/0.6 Python/3.12.15
Date: Wed, 14 Oct 2026 13:43:34 GMT
ETag: "76b90d86b0742cc0"
--- ④ 不存在的路径 → 404
HTTP/1.1 404 Not Found
Server: BaseHTTP/0.6 Python/3.12.15
Date: Wed, 14 Oct 2026 13:43:34 GMT
Content-Type: application/json
Content-Length: 21
[body] b'{"error":"not found"}'
--- ⑤ 分块传输(LLM 流式输出的底层形式之一)
HTTP/1.1 200 OK
Server: BaseHTTP/0.6 Python/3.12.15
Date: Wed, 14 Oct 2026 13:43:34 GMT
Content-Type: text/plain; charset=utf-8
Transfer-Encoding: chunked
[body] b'6\r\n\xe4\xbd\xa0\xe5\xa5\xbd\r\n3\r\n\xef\xbc\x8c\r\n6\r\n\xe6\x88\x91\xe6\x98\xaf\r\n6\r\n\xe5\xae\xa2\xe6\x9c\x8d\r\n0\r\n\r\n'
收到数据的时刻(ms,粗略): [0, 50, 100, 150, 201]
--- ⑥ 未实现的方法
HTTP/1.1 501 Unsupported method ('BREW')
  • ① 请求就是几行用 \r\n 分隔的文本,以空行结束;Host 头在 HTTP/1.1 中是必需的。
  • ② Content-Length: 51 是字节数:正文 19 个字符,UTF-8 下本例这些常用汉字各占3字节;其他Unicode字符不一定如此,共 51 字节。自己拼响应时按字符数算长度,客户端会截断或一直等待。
  • ③ 第二个请求复用了同一 TCP 连接(HTTP/1.1 默认长连接)。客户端带上次的 ETag,服务器判断内容没变,回 304 且没有正文——浏览器缓存和 CDN 依赖这个机制省流量。
  • ④ 404 的正文是 JSON:状态码说明“哪类问题”,正文说明“具体是什么”。
  • ⑤ 分块传输:每块是“十六进制长度 + 数据”,6 表示 6 字节(两个汉字),以 0 块结束;到达时刻在一稿本机实验中约每50ms到达;真实网络可以合并或拆分传输块。LLM API 的流式输出在 HTTP/1.1 上通常就是分块传输承载的 SSE(text/event-stream);HTTP/2 禁用了 Transfer-Encoding: chunked,改由 DATA 帧分段传输RFC 9113 §8.2.2:https://www.rfc-editor.org/rfc/rfc9113#section-8.2.2。
  • ⑥ 服务器不认识的方法 BREW 返回 501。

自测

问题: 一次recv只得到半个JSON响应,是否表示服务器发了坏数据?

参考答案: 不一定。TCP是字节流,一次读取可以是任意分段。应按HTTP消息边界收齐,再按内容协议解析,SSE也需要跨网络块累计事件。

常见误区

  • “HTTPS 是另一种协议”:HTTPS 是 HTTP 跑在 TLS 加密连接之上,报文语义相同。
  • “401 和 403 一样”:401表示缺少适用的有效认证凭证,403表示服务器理解但拒绝请求;403并不要求已识别用户身份(见 k6.sec.authentication、k6.sec.authorization)。
  • “GET 也可以随便改数据”:RFC 9110 规定 GET是安全方法,不应以改变业务状态作为请求目的;访问日志等附带行为不因此被禁止;爬虫、预取、缓存都会自由重发 GET。
  • “POST 失败了重试一下就行”:POST 不是幂等的,重试可能导致重复下单;需要幂等键(见 k6.web.rest-api)。

与 AI 开发的关系

  • 调 LLM API 遇到 429:读 Retry-After 头、指数退避重试;遇到 5xx:有限次重试;其他4xx需按错误语义处理,如冲突可能要求重新获取状态;不要原样无限重试。
  • 流式输出经过反向代理(Nginx 等)时,代理默认可能缓冲响应,导致“流式变成一次性”;需关闭代理缓冲Nginx proxy_buffering:https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffering。
  • curl -v 能打印完整请求与响应头,是排查 API 调用最快的工具。

延伸阅读

尚未验证的范围

  • 本例只覆盖有限HTTP/1.1响应,不是完整HTTP解析器;未验证HTTP/2、HTTP/3或真实反向代理链路。

本次示例运行范围

2026-10-15:通过。本地回环HTTP/1.1响应读取;有限报文边界。

查看本次日志。

“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。

配套代码与核验资料

继续浏览基础 返回知识 →返回顶部 ↑
本篇目录
教程图解100%
教程图解