在 Go 的 HTTP 服务中，仅依赖 json.Decoder.Decode 的 io.EOF 错误无法可靠识别空 JSON 对象（如 "{}"），因为该方法会成功解码空对象并忽略缺失字段——需先读取原始字节再判断长度，再按需反序列化。
在 go 的 http 服务中，仅依赖 `json.decoder.decode` 的 `io.eof` 错误无法可靠识别空 json 对象（如 `"{}"`），因为该方法会成功解码空对象并忽略缺失字段——需先读取原始字节再判断长度，再按需反序列化。
在 Go Web 开发中，一个常见误区是认为 json.NewDecoder(r.Body).Decode(&v) 返回 io.EOF 就代表请求体为空。但实际上，io.EOF 仅在读取到流末尾且未解析出任何有效 JSON 值时触发（例如完全无内容的 POST 请求）。而像 "{ }"、"{}" 或 {"a":true} 这类合法 JSON，即使所有字段均为零值或结构体未定义对应字段，Decode 仍会成功返回 nil 错误，并将结构体字段设为默认零值（如 bool 为 false，int32 为 0）——这正是问题中 hasOpts 仍为 true 的根本原因。
✅ 正确做法：先完整读取请求体字节，再根据长度决定是否解析。以下是推荐实现：
import (
"io"
"io/ioutil" // Go 1.16+ 建议改用 io.ReadAll，见下方说明
"encoding/json"
"fmt"
)
func handler(w http.ResponseWriter, r *http.Request) error {
// 1. 读取全部请求体（注意：r.Body 是 io.ReadCloser，需确保后续可重用或已关闭）
body, err := io.ReadAll(r.Body)
if err != nil {
return fmt.Errorf("failed to read request body: %w", err)
}
defer r.Body.Close() // 避免资源泄漏
// 2. 判断是否为空（空字节切片或仅含空白字符）
if len(body) == 0 || json.Valid(body) && string(bytes.TrimSpace(body)) == "{}" {
// 可选：明确区分「无内容」和「空 JSON 对象」
// 此处将空 JSON `{}` 视为“无有效选项”，不覆盖 opts 默认值
return nil
}
// 3. 非空时才执行 JSON 解析
var opts Request
if err := json.Unmarshal(body, &opts); err != nil {
return fmt.Errorf("could not parse advanced options: %w", err)
}
// 使用 opts...
}⚠️ 注意事项：
-
ioutil.ReadAll已弃用（Go 1.16+）：请使用io.ReadAll(r.Body)替代； -
r.Body只能读取一次：若需多次使用（如日志、鉴权），应提前缓存或使用http.MaxBytesReader限制大小； -
空白字符处理：
len(body) == 0仅检测完全无字节；若需兼容含空格/换行的"{} "，建议先bytes.TrimSpace再比较； -
性能考量：对超大请求体，全量读取可能影响内存，此时可结合
http.MaxBytesReader或流式校验（如用json.Decoder.Token()检查首字符）； -
语义区分：业务上常需区分
nil body（无数据）、{}（显式清空）和{"a":true}（部分设置），应按需设计逻辑分支。
总结：json.Decode 的成功 ≠ 请求体非空，它只保证 JSON 语法合法。要精准控制空体逻辑，必须主动读取并检查原始字节——这是 Go HTTP 处理中兼顾健壮性与语义清晰的关键实践。
