Go net/http.ReadRequest 怎样解析原始 HTTP 请求
来源:17golang原创
时间:2026-11-17 17:32:32 495浏览 收藏
把原始 HTTP/1.x 请求交给 bufio.Reader,调用 http.ReadRequest 得到 *http.Request。请求行和头字段解析完成后,正文仍通过 req.Body 读取;解析成功不等于正文已完整到达。
官方地址:https://pkg.go.dev/net/http#ReadRequest
先确定解析器的职责
假设我要给内部协议调试工具加入一份请求记录预览,我会先把“解析已有字节”和“建立 HTTP 服务”分开。这里选择前者:输入是一条完整内存请求,结果用于展示方法、路径、主机及正文。它不监听端口,也不发送请求。以下是设计取舍与人工样例,不是一次真实线上排障记录。
ReadRequest 面向 HTTP/1.x。普通服务器更适合使用 http.Server,客户端构造请求使用 NewRequest;HTTP/2 的二进制帧不能直接当成本例文本输入。这里没有新版本语义变更,所谓改写只是把手工拆分替换为标准库解析。
让请求行与头字段交给标准库
按空格和换行自己 Split,初看能取出几个字段,但很容易混淆路径与查询串,也会丢失重复头字段。标准库给出有明确职责的字段:Method 保存方法,RequestURI 保留请求目标,URL.Path 用于路径,URL.RawQuery 保存查询串。服务端请求的 Host 单独保存在 req.Host,不要只到 Header.Get("Host") 里寻找。

示例采用 CRLF 和明确的空行表达线上的头部结构。Content-Length 对应正文的字节数,不能用汉字数量代替。需要同名字段的全部值时,使用 Header.Values;只取一个值时才使用 Header.Get。
单独读取并关闭请求体
这份完整 Go 示例只依赖标准库。它设置 1024 字节的演示正文上限,并读取上限加一字节判断超限;这个数值是样例选择,不是标准库默认值。
package main
import (
"bufio"
"fmt"
"io"
"net/http"
"strings"
)
func inspect(raw string) error {
// 这是完整内存样例,只处理一个 HTTP/1.x 请求。
br := bufio.NewReader(strings.NewReader(raw))
req, err := http.ReadRequest(br)
if err != nil { return fmt.Errorf("解析请求头: %w", err) }
defer req.Body.Close() // 本例内存输入有限,关闭请求体释放读取状态。
const maxBody = 1024
// 多读取一个字节才能区别恰好达到上限和真正超限。
body, err := io.ReadAll(io.LimitReader(req.Body, maxBody+1))
if err != nil { return fmt.Errorf("读取请求体: %w", err) }
if len(body) > maxBody { return fmt.Errorf("请求体超过示例上限") }
fmt.Printf("method=%s path=%s host=%s body=%q\n",
req.Method, req.URL.Path, req.Host, body)
return nil
}
func main() {
// Content-Length 按正文的字节数填写,空行分隔头字段与正文。
raw := "POST /notes?mode=brief HTTP/1.1\r\n" +
"Host: example.com\r\nContent-Type: text/plain\r\n" +
"Content-Length: 5\r\n\r\nhello"
if err := inspect(raw); err != nil { fmt.Println(err) }
}
对这个构造输入,预期得到 POST、/notes、example.com 与正文 hello;查询串仍在 URL.RawQuery 中。这里没有宣称已经运行该代码。读请求体时出现截断错误,必须向调用方返回,不能把部分正文当成成功结果。

LimitReader 只限制这次读取量,不限制请求头解析,也不设置网络超时。示例的 defer Close 适用于有限内存输入;如果换成真实连接,关闭未读完的正文可能涉及继续读取,必须结合连接截止时间和丢弃连接策略设计,不能照搬为完整网络接入层。
区分错误与适用场景
| 阶段 | 含义 | 处理 |
|---|---|---|
| ReadRequest 失败 | 头部、请求行或输入读取失败 | 停止使用请求对象 |
| Body 读取失败 | 正文未完整取得 | 保留错误,不展示为成功 |
| 正文超限 | 超出工具自己的容量策略 | 拒绝当前记录 |
如果输入是连续多个请求,必须复用同一个 bufio.Reader,并在正文处理完整后再解析下一条;不要绕过它直接从底层连接读取,因为读取器可能已经缓存后续字节。本例只处理一条请求,超限后直接终止,不尝试恢复到下一条记录。
为什么 URL.Scheme 或 URL.Host 为空?
常见 origin-form 请求目标只有路径和查询串。请求主机应查看 req.Host,不要要求 URL 一定包含完整网址。
读完 Body 后还能再读一遍吗?
一般不能自动重放。需要多次展示时,先在容量上限内保存正文副本;本例的 body 就是这一份副本,别再假设 req.Body 会返回相同数据。
解析成功就能直接转发吗?
不能把读取函数等同于代理实现。转发还涉及目标选择、头字段策略和连接生命周期。本例只服务离线解析与受控输入工具,不扩展到代理或路由实现。
-
133 收藏
-
179 收藏
-
292 收藏
-
346 收藏
-
475 收藏
-
493 收藏
-
368 收藏
-
106 收藏
-
135 收藏
-
283 收藏
-
Golang · Go问答 | 2小时前 | 标准库 · csv · Go问答 · Go encoding/csv CSV注释行 csv.Reader.Comment TrimLeadingSpace104 收藏
-
Golang · Go问答 | 2小时前 | 标准库 · 错误处理 · csv · Go问答 · Go error FLUSH encoding/csv csv.Writer CSV分隔符 Writer.Comma457 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习