第 1 章:一次请求的完整旅程
你按下"发送",到屏幕上出现结果,中间只有几百毫秒。这几百毫秒里发生了五件事,每一件出问题,表现都不一样:域名解析失败、连不上、证书报错、404、超时。
学习目标
- 把一条 URL 拆成五段,说清每段决定什么
- 描述一次 HTTPS 请求从输入域名到收到响应的完整链路
- 理解"HTTP 是无状态的",知道为什么每次都要带凭证
- 遇到请求失败时,能判断问题出在链路的哪一环
1.1 先建立一个直觉:HTTP 就是寄信
把一次请求想成寄一封信:
| 寄信 | HTTP |
|---|---|
| 收件地址 | URL |
| 信封上写"挂号信"还是"平信" | 请求方法(GET / POST) |
| 信封上的附加说明 | 请求头(Headers) |
| 信纸内容 | 请求体(Body) |
| 对方的回信 | 响应(状态码 + 响应头 + 响应体) |
这个比喻能解释 80% 的行为。剩下的 20%,是"信在路上怎么走"——也就是这一章要讲的。
1.2 URL:五段拼出"去哪里、找什么"
先看一个真实的大模型接口地址:
五段的分工:
| 段 | 例子 | 决定什么 | 出错的典型表现 |
|---|---|---|---|
| 协议 | https:// | 用什么方式说话、要不要加密 | 证书错误、https 连 http 端口失败 |
| 域名 | api.example.com | 找哪台机器(要解析成 IP) | DNS 解析失败、域名不存在 |
| 端口 | :443 | 机器上的哪个服务 | 连接被拒绝(服务没起或端口错) |
| 路径 | /v1/chat/completions | 要哪个资源、调哪个接口 | 404 Not Found |
| 查询参数 | ?stream=true | 附带的筛选/开关条件 | 参数拼错,返回默认行为 |
两个常被忽略的点:
- 端口可以省略。
https默认 443,http默认 80。写https://api.example.com等价于https://api.example.com:443。 - 路径区分大小写,
/V1/Chat和/v1/chat在很多服务器上是两个东西。查询参数一般用&连接多个:?stream=true&model=gpt-4o。
1.3 请求在路上:五步走完
有了地址,接下来是"怎么送到"。以 HTTPS 为例:
逐步看:
第一步:DNS 解析
域名只是给人看的,机器只认 IP。DNS 的工作就是"查电话簿"。这一步失败,报错通常是 Name or service not known / getaddrinfo failed。
第二步:TCP 连接
拿到 IP 后,客户端和服务器要先建立一条可靠的连接(三次握手)。这一步失败,常见报错是 Connection refused(端口没人监听)或 Connection timed out(网络不通/被防火墙拦)。
第三步:TLS 握手(仅 HTTPS)
双方确认"对面确实是这个域名"(校验证书),并协商出一套加密方式。这一步失败就是证书问题:SSL certificate problem、certificate verify failed。
为什么大模型 API 必须用 HTTPS:API Key 在请求头里明文传输,没有 TLS 就等于把钥匙写在信封外面。
第四步:发请求
真正的内容在这一步才发出去:请求行(方法 + 路径)、请求头(Host、Authorization、Content-Type……)、请求体(POST 时的数据)。
第五步:收响应
服务器返回状态码、响应头和响应体。第 2、3 章会详细拆。
复用:频繁调同一个接口时,TCP 和 TLS 不必每次都重建。连接池(第 4 章)做的就是这件事——这也是为什么"复用连接"能显著降低延迟。
1.4 无状态:服务器不记得你
HTTP 有一条根本设计:每个请求都是独立的,服务器不自动记得上一个请求是谁发的。
这带来一个直接后果:登录之后,下一个请求凭什么证明"还是你"?
靠每次请求都带上凭证,常见三种:
| 方式 | 带在哪 | 典型场景 |
|---|---|---|
| Cookie | 请求头 Cookie | 浏览器里的会话 |
| Bearer Token | 请求头 Authorization: Bearer xxx | API 调用、移动端 |
| API Key | 请求头或查询参数 | 第三方服务、大模型 API |
POST /v1/chat/completions HTTP/1.1
Host: api.example.com
Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json"无状态"不是缺点,是优点:服务器不必为每个用户保存会话,扩容时不用同步状态。代价是凭证要在每次请求里重复携带,也就带来了"密钥怎么存"的问题(第 5 章)。
1.5 亲手看一次请求
浏览器里按 F12 打开开发者工具,切到 Network 面板,随便点一个页面,能看到每条请求的:
- 方法、URL、状态码、耗时;
- 请求头(含
Authorization,如果带了的话); - 响应头和响应体。
命令行里也可以用 curl -v 看到握手和报文:
curl -v https://api.example.com/v1/models输出里以 > 开头的是你发出去的,< 开头的是收到的。第一次看会觉得吵,但它是排查问题最直接的工具:连接问题看前面几行,业务问题看状态码和响应体。
本章小结
| 要点 | 说明 |
|---|---|
| URL 五段 | 协议、域名、端口、路径、查询参数 |
| 端口可省略 | https 默认 443,http 默认 80 |
| 请求五步 | DNS → TCP → TLS → 发请求 → 收响应 |
| 报错定位 | 解析失败、连接拒绝、证书错误、404、超时各对应一环 |
| HTTP 无状态 | 每次请求都要自带凭证 |
| 三种凭证 | Cookie、Bearer Token、API Key |
| 排查工具 | 浏览器 Network、curl -v |
下一章
地址和链路清楚了,下一章讲"这封信到底该怎么写":为什么查数据用 GET、提交数据用 POST,以及服务器返回的 200、301、401、404、500 分别意味着什么、该不该重试。