HTTP 请求没有返回 Go error只能说明客户端拿到了一个响应不能说明里面的数据能继续使用。502 错误页、超大 JSON、截断字符串和缺失金额都可能从同一个入口进来。对于报价、退款金额这类字段我宁愿明确失败也不补一个引号后把半截内容当事实交给下游。四种失败不要揉成“解析异常”net/http 的 Client.Do 文档说明非 2xx 状态本身不会自动成为调用错误。读取响应时还要处理大小、语法和业务字段。层次构造输入应有处理HTTP502 与 HTML 页面记录状态拒绝进入业务解析体积与编码超限、非法 UTF-8拒绝不截成一个“可用前缀”JSON半截对象、第二个根值拒绝不自动修补业务契约合法对象但缺少金额拒绝不用零值代替缺失图是通用检查示意。本例业务只接受 200204 即使属于 2xx也没有所需金额正文。N1 是检测超限的读取方式不是一类 HTTP 错误。下面给一个完整的金额响应读取器。金额使用指针是为了区分“没有这个字段”和“金额确实是 0”。package main import ( bytes encoding/json errors fmt io mime net/http unicode/utf8 ) type Quote struct { Amount *int64 json:amount } func readQuote(resp *http.Response, max int64) (Quote, error) { var q Quote defer resp.Body.Close() if max 1 || max 120 { return q, errors.New(bad limit) } if resp.StatusCode ! http.StatusOK { return q, errors.New(http status) } media, _, err : mime.ParseMediaType(resp.Header.Get(Content-Type)) if err ! nil || media ! application/json { return q, errors.New(media type) } b, err : io.ReadAll(io.LimitReader(resp.Body, max1)) if err ! nil { return q, errors.New(body read) } if int64(len(b)) max { return q, errors.New(body too large) } if !utf8.Valid(b) { return q, errors.New(invalid utf8) } dec : json.NewDecoder(bytes.NewReader(b)) dec.DisallowUnknownFields() if err : dec.Decode(q); err ! nil { return q, errors.New(json syntax) } var extra any if err : dec.Decode(extra); err ! io.EOF { return q, errors.New(trailing json) } if q.Amount nil || *q.Amount 0 { return q, errors.New(amount missing or negative) } return q, nil } func main() { for _, body : range []string{{amount:0}, {}, {amount:50} { resp : http.Response{StatusCode:200, Header:http.Header{Content-Type:[]string{application/json}}, Body:io.NopCloser(bytes.NewBufferString(body))} q, err : readQuote(resp, 128) fmt.Printf(accepted%t amount_present%t\n, err nil, q.Amount ! nil) } }N1 读取很重要。只读 N 字节拿到 N 字节时分不清响应刚好等长还是后面还有内容多读一个字节才能判定超限。这里也限制了 max 的范围避免调用方传入异常上限。此示例还有明确取舍仅接受 application/json若业务允许某个 json 媒体类型应把它加入显式契约。未知字段一律拒绝也会影响前向兼容版本化接口可以使用不同策略不能拿严格解析替代版本设计。留证据不等于把原始响应全部打进日志需要保留的通常是请求 ID、上游标识、HTTP 状态、错误分类、响应长度与经过审查的样本摘要。完整报文可能包含地址、令牌和财务字段不能顺手进入公共日志。样本应有访问控制、保留期限和脱敏规则。错误分类也不要伪装成根因。body read 只能表示读取失败可能是断流、超时或其他 I/O 错误内部记录应保留原始 err面向调用方则返回稳定的错误类别。encoding/json 文档定义的是 JSON 编解码行为不会替你证明金额来自正确订单。订单归属、币种和规则版本仍是业务校验。本地以 Go 1.26.5 运行构造响应并补充内存响应与 Body 关闭断言验证记录独立保存。没有访问上游生产接口。
