Go http.NoBody 与 nil Body 有什么区别

在 Go 的 net/http 代码里，空请求体经常有两种写法：把 Request.Body 留成 nil，或者显式设置为 http.NoBody。它们都可以表达“没有要发送的字节”，但表达层次不同：nil 是“没有 Body 对象”，http.NoBody 是“有一个明确的零字节 io.ReadCloser”。

实际选择可以先记住一句话：普通客户端 GET 或无体请求优先使用 nil；需要把“空但可读、可关闭的 Body”作为接口值传递，或要在测试中明确观察 EOF 与 Close 时，使用 http.NoBody。

一、nil Body 和 http.NoBody 的核心区别

http.NoBody 是标准库提供的零字节 io.ReadCloser：读取立即返回 io.EOF，关闭返回 nil。而客户端请求的 nil Body 表示没有请求体，Transport 负责按无体请求发送。

二、为什么空请求体仍然要区分对象语义

很多代码把 Body 当作普通接口使用。例如中间件会统一读取并关闭它，或者测试桩需要验证读取端是否在无数据时返回 EOF。此时用 nil 会迫使每一层都写判空分支；用 http.NoBody 则可以保持“这是一个可读、可关闭的流”的接口约定。

但这不意味着 http.NoBody 会发送一个带有额外内容的 HTTP 请求。它本身没有字节。最终的请求头和传输细节仍由 http.Transport、请求方法、ContentLength 以及其它字段共同决定，不能只根据 Body 是否为 nil 推断完整报文。

三、客户端 Request.Body：通常让 nil 表达无体

构造普通客户端请求时，http.NewRequest 接收的 body 参数是 io.Reader。传入 nil 是最直观的无体请求表达。标准库在构造请求时还会根据可识别的空读取器设置相关字段，因此不要为了“看起来更完整”而无条件替换成自定义空 Reader。

package main

import (
    "fmt"
    "net/http"
)

func main() {
    // nil 表示这个客户端请求没有要发送的请求体。
    req, err := http.NewRequest(http.MethodGet, "https://example.com/health", nil)
    if err != nil {
        panic(err)
    }

    // 这里只观察构造结果；真正发送前仍应由调用方处理 err 和 resp.Body。
    fmt.Printf("body-is-nil=%t content-length=%d\\n", req.Body == nil, req.ContentLength)
}

这类请求没有必要为了调用 Close 而人为创建 Body。若业务层把请求统一交给一个会先读后关的管道，则可以使用 http.NoBody，让管道保持同一个 io.ReadCloser 合约。

四、http.NoBody 的直接行为：EOF 和 Close 都是确定的

当测试或适配层需要一个“不会阻塞、永远为空”的读取器时，http.NoBody 比手写空类型更清楚。下面的例子同时检查读取结果和关闭结果；注释只保留与判断有关的关键点。

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    // NoBody 是明确存在的零字节 ReadCloser。
    body := http.NoBody
    buf := make([]byte, 8)
    n, readErr := body.Read(buf)
    closeErr := body.Close()

    // 读取应为 0 字节和 EOF，关闭应成功，便于统一清理路径。
    fmt.Printf("n=%d eof=%t close-ok=%t\\n", n, readErr == io.EOF, closeErr == nil)
}

五、服务端 Request.Body 不能照搬客户端判断

同一个字段在服务端请求上有不同约定：服务端收到的 Request.Body 通常非空，即使请求没有正文，读取也会立即得到 EOF。处理器不需要负责关闭服务端请求体，服务端会完成这项工作。

因此，服务端代码不应通过 r.Body == nil 判断“客户端有没有发正文”，也不应把服务端的 Body 替换成 http.NoBody 来模拟客户端。要判断正文是否为空，应按读取结果、请求头或业务协议处理。

六、测试中什么时候选 http.NoBody

如果被测函数的输入类型是 io.ReadCloser，并且它的契约要求无论是否有数据都要执行读取和关闭，那么 http.NoBody 是合适的测试输入。它能让测试覆盖“读取到 EOF”和“关闭不报错”这两个确定分支。

func consume(body io.ReadCloser) (int64, error) {
    // 无论读取是否成功，都把关闭责任留在这个消费函数内。
    defer body.Close()
    return io.Copy(io.Discard, body)
}

func example() {
    // NoBody 让 consume 不需要额外的 nil 分支。
    count, err := consume(http.NoBody)
    fmt.Println(count, err)
}

若函数的参数本来就是 *http.Request，则更接近真实客户端语义的测试通常是用 http.NewRequest 传入 nil，再观察请求构造和 RoundTripper 的行为。测试目标不同，输入也应不同。

七、排查空 Body 问题的检查清单

1. 先确认当前对象是客户端请求还是服务端请求。
2. 如果代码会直接调用 Read 或 Close，确认是否已经处理 nil；没有判空时可考虑传入 http.NoBody。
3. 不要只看 Body，同时检查 ContentLength、请求方法和自定义 RoundTripper。
4. 服务端不要用 r.Body == nil 判断空正文，读取到 io.EOF 才是更符合服务端约定的信号。
5. 谁创建了客户端 Body，谁要确认关闭责任；使用 http.NoBody 时关闭本身不会产生错误。

总结

nil Body 和 http.NoBody 都能表达客户端没有正文，但前者强调“没有对象”，后者强调“有一个确定为空的 ReadCloser”。普通无体请求用 nil 最自然；统一流式接口、测试 EOF、集中清理路径时用 http.NoBody 更清楚。服务端 Body 另有非空约定，不能把客户端的判断方式直接复制过去。

相关问题

http.NoBody 会让请求多发送一个空字节吗？不会。它读取不到任何字节；网络报文的具体表示仍由 HTTP 客户端和请求字段决定。

服务端处理器需要关闭 r.Body 吗？按 net/http 的服务端约定，服务端负责关闭请求体，处理器通常不需要自行关闭。