HTTP 与 Web 标准 / 系统课时
拆解一个完整 URL
拆解一个完整 URL
URL 决定客户端“用什么方式、去哪个主机、访问哪个资源,并携带哪些参数”。把 scheme、host、port、path、query 和 fragment 分开后,你能准确判断请求会发往哪里、服务器会看到什么,以及哪些部分只留在客户端。
学习目标
- 识别完整 URL 的六个常见组成部分
- 判断各部分如何影响连接目标和 HTTP 请求目标
- 理解 fragment 为什么不会随 HTTP 请求发送给服务器
从一个 URL 看各部分
以这个地址为例:
https://api.example.com:8443/v1/search?q=http&lang=zh#result它可以拆成:
| 部分 | 示例值 | 作用 |
|---|---|---|
| scheme | https |
指定使用的 URI 方案;对 Web 请求通常也决定是否使用 TLS |
| host | api.example.com |
标识目标主机,通常需要进一步解析为网络地址 |
| port | 8443 |
指定目标端口;省略时通常使用 scheme 对应的默认端口 |
| path | /v1/search |
标识目标资源或路由路径 |
| query | q=http&lang=zh |
以键值形式附加查询条件或输入参数 |
| fragment | result |
标识文档内部位置或客户端状态,不发送给 HTTP 服务器 |
需要注意术语差异:概念上常把主机名叫 host;而在 JavaScript 的 URL API 中,hostname 只包含主机名,host 则可能包含 :port。
哪些部分真正影响请求
scheme 会影响客户端采用的访问方式。对于 https,客户端通常还要进行 TLS 握手;host 与 port 共同决定连接的目标端点;path 与 query 会组成服务器可见的请求目标。
对上面的示例,HTTP 请求目标可理解为:
/v1/search?q=http&lang=zhfragment #result 不属于发送给服务器的 HTTP 请求目标。浏览器可以用它滚动到页面锚点,也可以让前端路由保存客户端状态,但服务端不会因为 URL 后面多了 #result 就收到不同的 fragment 值。
用代码验证拆解结果
Node.js 内置的 URL 类可以直接解析这些部分。下面示例不依赖第三方包。
const url = new URL(
"https://api.example.com:8443/v1/search?q=http&lang=zh#result"
);
// hostname 不包含端口,host 会保留显式端口。
console.log(`protocol=${url.protocol}`);
console.log(`hostname=${url.hostname}`);
console.log(`port=${url.port}`);
console.log(`pathname=${url.pathname}`);
console.log(`search=${url.search}`);
console.log(`hash=${url.hash}`);
console.log(`requestTarget=${url.pathname}${url.search}`);预期输出
protocol=https:
hostname=api.example.com
port=8443
pathname=/v1/search
search=?q=http&lang=zh
hash=#result
requestTarget=/v1/search?q=http&lang=zh输出里 requestTarget 只拼接 path 与 query,没有包含 hash。这正好对应 HTTP 请求时服务器真正接收到的目标部分。
省略端口时不要误判
URL 中没有显式端口,不代表“没有端口”。客户端会依据 scheme 选择默认端口,例如 HTTP 常用 80,HTTPS 常用 443。反过来,如果 URL 明确写了其他端口,连接就会尝试访问那个端口。
同样,query 的语义由应用定义。?page=2、?q=http 只是常见约定,HTTP 本身不会规定参数名必须表示什么。path 也不等同于真实磁盘路径,它通常只是服务端路由系统用于匹配资源或处理器的标识。
判断一个 URL 时按连接与请求分层
遇到 URL 访问异常,可以先检查 scheme、host、port 是否把客户端带到了正确的服务,再检查 path 和 query 是否命中了正确资源。fragment 通常属于客户端侧行为,不应拿它解释“服务器为什么没收到这个参数”。
掌握这种拆分方式后,看到任何 Web 地址都可以先回答两个问题:客户端要连接到哪里,以及服务器最终会看到什么请求目标。