登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

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 会返回相同数据。

解析成功就能直接转发吗?

不能把读取函数等同于代理实现。转发还涉及目标选择、头字段策略和连接生命周期。本例只服务离线解析与受控输入工具,不扩展到代理或路由实现。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>