二稿核验说明(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
| 状态码类别 | 含义 | 常见例子 |
|---|---|---|
| 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):
- RFC9110:HTTP语义:安全、幂等、条件请求与状态码。
- RFC9113:HTTP/2:禁用HTTP/1.1连接专用字段及分块编码。
可运行示例
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 调用最快的工具。
延伸阅读
- MDN HTTP 状态码:https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Status
- Server-Sent Events 规范(HTML Living Standard):https://html.spec.whatwg.org/multipage/server-sent-events.html
尚未验证的范围
- 本例只覆盖有限HTTP/1.1响应,不是完整HTTP解析器;未验证HTTP/2、HTTP/3或真实反向代理链路。
本次示例运行范围
2026-10-15:通过。本地回环HTTP/1.1响应读取;有限报文边界。
“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。
配套代码与核验资料