Skip to content
Lv1HTTP 与 JSON进度 1 / 6

第 1 章:一次请求的完整旅程 ​

你按下"发送",到屏幕上出现结果,中间只有几百毫秒。这几百毫秒里发生了五件事,每一件出问题,表现都不一样:域名解析失败、连不上、证书报错、404、超时。


学习目标 ​

  • 把一条 URL 拆成五段,说清每段决定什么
  • 描述一次 HTTPS 请求从输入域名到收到响应的完整链路
  • 理解"HTTP 是无状态的",知道为什么每次都要带凭证
  • 遇到请求失败时,能判断问题出在链路的哪一环

1.1 先建立一个直觉:HTTP 就是寄信 ​

把一次请求想成寄一封信:

寄信HTTP
收件地址URL
信封上写"挂号信"还是"平信"请求方法(GET / POST)
信封上的附加说明请求头(Headers)
信纸内容请求体(Body)
对方的回信响应(状态码 + 响应头 + 响应体)

这个比喻能解释 80% 的行为。剩下的 20%,是"信在路上怎么走"——也就是这一章要讲的。


1.2 URL:五段拼出"去哪里、找什么" ​

先看一个真实的大模型接口地址:

https://api.example.com:443/v1/chat/completions?stream=true协议 scheme域名 host端口 port路径 path查询参数 query协议决定怎么加密 · 域名决定找哪台机器 · 端口决定哪个服务 · 路径决定要哪个资源 · 参数决定怎么筛

五段的分工:

段例子决定什么出错的典型表现
协议https://用什么方式说话、要不要加密证书错误、https 连 http 端口失败
域名api.example.com找哪台机器(要解析成 IP)DNS 解析失败、域名不存在
端口:443机器上的哪个服务连接被拒绝(服务没起或端口错)
路径/v1/chat/completions要哪个资源、调哪个接口404 Not Found
查询参数?stream=true附带的筛选/开关条件参数拼错,返回默认行为

两个常被忽略的点:

  1. 端口可以省略。https 默认 443,http 默认 80。写 https://api.example.com 等价于 https://api.example.com:443。
  2. 路径区分大小写,/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 xxxAPI 调用、移动端
API Key请求头或查询参数第三方服务、大模型 API
http
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 看到握手和报文:

bash
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 分别意味着什么、该不该重试。

👉 第 2 章:方法与状态码

本文阅读--次|全站访问--次|访客--人