最常见的原因是没读取完整响应体，或者响应本身含BOM、空格、HTML错误页等干扰内容；Go的http.Client不会自动跳过非2xx响应体，如404返回HTML页面时直接解析会触发invalid character '<'。
HTTP 请求发出去但 json.Unmarshal 报错：invalid character
最常见的原因是没读取完整响应体，或者响应本身含 BOM、空格、HTML 错误页等干扰内容。Go 的 http.Client 不会自动跳过 HTTP 状态码非 2xx 的响应体，比如服务端返回 404 时可能返回 HTML 页面，直接丢给 json.Unmarshal 就会触发 invalid character ' 这类错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 始终检查
resp.StatusCode，非 2xx 时提前返回错误，避免解析无效内容 - 用
io.ReadAll(resp.Body)完整读取，别用bufio.Scanner或部分读取 - 读取后先用
bytes.TrimSpace去首尾空白，再尝试解析 - 调试时打印原始字节（
fmt.Printf("raw: %s", string(data))），确认是不是 JSON 格式
结构体字段无法反序列化：明明字段名对得上，却一直是零值
Go 的 json 包默认只导出（首字母大写）且带 JSON tag 的字段才能被反序列化。即使字段名拼写完全一致，如果没加 json:"xxx" tag，或字段是小写开头，json.Unmarshal 就会跳过它。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 结构体字段必须首字母大写（导出）
- 显式声明
jsontag，尤其注意大小写和下划线映射，例如 API 返回user_id，结构体字段应为UserID int `json:"user_id"` - 对可选字段使用指针或
omitempty，比如Name *string `json:"name,omitempty"`，避免零值覆盖业务逻辑 - 不确定字段类型时，先用
map[string]interface{}解析，确认结构再定义结构体
超时控制失效：请求卡住十几秒才返回，context.WithTimeout 没起作用
单纯给 http.Request 加 context 不够，必须把 context 传给 http.Client 实例，否则底层 TCP 连接、DNS 查询、TLS 握手阶段都不会受控。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 创建 client 时设置
Timeout或用http.DefaultClient的拷贝 + 自定义Transport - 更可靠的做法：用
context.WithTimeout创建 ctx，再通过req = req.WithContext(ctx)注入，并确保 client 的Transport支持 cancel（标准库默认支持） - 区分连接超时和读写超时：
http.Transport的DialContext控制建连，ResponseHeaderTimeout和ReadTimeout控制后续阶段 - 避免复用全局 client 时意外覆盖 timeout 设置；不同业务场景建议按需构造 client
中文乱码或特殊字符解析失败：返回 JSON 里有中文，但结构体字段是空字符串
不是编码问题，而是 Go 的 json 包原生支持 UTF-8，只要响应头声明了 Content-Type: application/json; charset=utf-8（或没声明，默认 utf-8），就不会乱码。真正的问题通常是响应体被中间件/代理篡改，或服务端实际返回 GBK 编码但声称是 UTF-8。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
resp.Header.Get("Content-Type")确认实际响应头，不要依赖文档 - 若发现
charset=gbk，需先用golang.org/x/text/encoding/charmap转换字节再解析 - 检查是否因 gzip 响应未解压导致乱码：设置
client.Transport = &http.Transport{DisableCompression: true}临时验证 - 结构体字段类型别用
[]byte存文本，除非明确需要二进制处理；字符串就用string
resp.Body 会失败，流式响应没关 Body 会导致连接泄漏，还有各种中间件悄悄修改响应体。这些细节不报错，但会让行为变得不可预测。 
