Go / 系统课时

构造出站请求

构造出站请求

出站 HTTP 请求不仅要得到正确的 URL,还要同时处理请求体、查询参数、头字段和取消信号。本节用一个可运行的 JSON POST 示例串起这些要素,并说明 Context 与客户端总超时如何共同限制下游调用的生命周期。

学习目标

  • 使用 http.NewRequestWithContext 创建可取消的出站请求
  • 正确编码 JSON 请求体、查询参数和必要头字段
  • 理解上游取消、Context 截止时间与 Client.Timeout 的关系

让出站请求继承上游生命周期

在 Web Handler 中调用下游服务时,应优先把 r.Context() 传给 http.NewRequestWithContext。客户端断开、服务器主动取消或上游截止时间到达后,取消信号会继续传给下游 HTTP 调用,避免请求已经失去意义后仍占用连接和 goroutine。

如果某个下游需要更严格的时间预算,可以从上游 Context 派生更短的子 Context;不要改用 context.Background(),否则会切断原有的取消链路。

上游请求与下游 HTTP 调用的 Context 取消传播链

编码查询参数和 JSON 请求体

下面程序在随机本地端口启动一个最小 HTTP 服务,再发送 POST /audit?source=web。查询参数交给 net/url 编码,请求体交给 encoding/json 生成,从而避免手工拼接 URL 或 JSON 时遗漏转义。

go
package main

import (
    "bytes"
    "context"
    "encoding/json"
    "fmt"
    "io"
    "net"
    "net/http"
    "net/url"
    "time"
)

type AuditRequest struct {
    User   string `json:"user"`
    Action string `json:"action"`
}

type AuditResponse struct {
    Source string `json:"source"`
    User   string `json:"user"`
    Action string `json:"action"`
}

func main() {
    listener, err := net.Listen("tcp", "127.0.0.1:0")
    if err != nil {
        panic(err)
    }

    handler := http.NewServeMux()
    handler.HandleFunc("/audit", func(w http.ResponseWriter, r *http.Request) {
        var input AuditRequest
        if err := json.NewDecoder(r.Body).Decode(&input); err != nil {
            http.Error(w, "invalid json", http.StatusBadRequest)
            return
        }

        w.Header().Set("Content-Type", "application/json")
        _ = json.NewEncoder(w).Encode(AuditResponse{
            Source: r.URL.Query().Get("source"),
            User:   input.User,
            Action: input.Action,
        })
    })

    server := &http.Server{Handler: handler}
    go func() {
        if err := server.Serve(listener); err != nil && err != http.ErrServerClosed {
            panic(err)
        }
    }()
    defer func() { _ = server.Close() }()

    // 独立程序没有上游请求,因此以 Background 为根;真实 Handler 应从 r.Context() 派生。
    ctx, cancel := context.WithTimeout(context.Background(), time.Second)
    defer cancel()

    endpoint, err := url.Parse("http://" + listener.Addr().String() + "/audit")
    if err != nil {
        panic(err)
    }
    query := endpoint.Query()
    query.Set("source", "web")
    endpoint.RawQuery = query.Encode()

    payload, err := json.Marshal(AuditRequest{User: "alice", Action: "sync"})
    if err != nil {
        panic(err)
    }

    requestMethod := http.MethodPost
    req, err := http.NewRequestWithContext(
        ctx,
        requestMethod,
        endpoint.String(),
        bytes.NewReader(payload),
    )
    if err != nil {
        panic(err)
    }

    // 只声明当前下游真正需要的字段,不复制整个上游 Header。
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{Timeout: 2 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer func() { _ = resp.Body.Close() }()

    responseBody, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(resp.Status)
    fmt.Print(string(responseBody))
}

预期输出

text
200 OK
{"source":"web","user":"alice","action":"sync"}

本地测试服务监听随机端口 <PORT>,实际值每次运行可能不同;程序只打印状态和响应体,因此动态端口不会出现在预期输出中。

只传播必要的头字段

JSON 请求通常需要用 Content-Type 声明请求体格式,并可用 Accept 表达期望的响应格式。认证信息、链路追踪标识等字段是否向下游传播,应由服务边界决定,而不是把上游 Header 整体复制过去。

整体复制可能把 Cookie、内部凭据或只对当前连接有意义的字段带到错误的服务。更稳妥的做法是维护允许传播的字段集合,并为下游认证单独生成或获取凭据。

让最先到达的限制终止调用

请求同时受 Context 和 http.Client.Timeout 约束时,先到达的限制会结束调用。示例中的 Context 截止时间为 1 秒,而客户端总超时为 2 秒,因此如果下游长时间不返回,Context 会先取消请求。

Client.Timeout 覆盖客户端调用的整体时间,包括建立连接、重定向以及读取响应体;请求自身的 Context 则更适合承接上游取消和业务时间预算。真实 Handler 中仍应让出站请求继承 r.Context(),必要时再派生更短的截止时间。

如果上游只剩 300 毫秒预算,下游不应重新获得一个与上游无关的数秒 Context。构造出站请求时,可以把 URL、参数、JSON 与 Header 看作请求内容,把 Context 和客户端超时看作请求生命周期;两部分同时正确,正常返回、上游取消和超时路径才都可控。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构造出站请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通