Go http.Request 如何复制请求并替换目标地址

在网关转发、灰度路由或多地域容灾里，经常要把一份 Go 请求复制到另一个目标地址。直接写 copy := *req 只是浅拷贝，Header、URL 等引用字段仍可能和原请求共享，后续修改容易产生数据竞争或污染原请求。更稳妥的做法是先调用 req.Clone(ctx)，再替换副本的 URL，并单独检查 Host 与 Body。

核心写法是：clone := req.Clone(ctx)，解析新地址后赋给 clone.URL。Clone 会深拷贝多数请求字段，但 Body 仍是浅拷贝；如果要发送两次带请求体的请求，必须准备可重建的 Body。

先分清 Clone、WithContext 和直接赋值的边界

Request.Clone 返回带新 Context 的深拷贝，官方文档特别注明 Body 只做浅拷贝。Header、URL、Trailer、TransferEncoding 等引用或切片字段由副本独立持有，适合在副本上做改址和加头操作。WithContext 只返回浅拷贝，适合只换上下文、不打算改动其他引用字段的场景。

用 Clone 创建独立请求并替换 URL

改址时不要修改传入的原请求。先用 Clone 复制，再用 url.Parse 解析完整目标地址。这样新 URL 的 Scheme、Host、Path 和 RawQuery 会作为一个整体进入副本，原请求仍保持不变。

func cloneTo(req *http.Request, ctx context.Context, target string) (*http.Request, error) {
	// Clone 复制可变请求字段；Body 仍然与原请求共享读取流。
	clone := req.Clone(ctx)

	// 解析完整地址，避免只改 Host 时遗漏 Scheme 或 RawQuery。
	u, err := url.Parse(target)
	if err != nil {
		return nil, fmt.Errorf("parse target URL: %w", err)
	}
	if u.Scheme == "" || u.Host == "" {
		return nil, fmt.Errorf("target URL must be absolute")
	}
	clone.URL = u
	return clone, nil
}

调用方可以继续使用原来的方法和 Header，但应把新请求交给独立的 http.Client 调用。这里没有改原请求的 URL 指针，也没有把一个不完整的字符串直接塞进 URL 字段。

处理 Host、查询参数和 RequestURI

客户端连接哪个服务器看的是 clone.URL.Host；而非空的 clone.Host 会覆盖请求发出的 Host 值。若目标域名也应作为 Host，通常要把继承来的自定义 Host 清空；如果业务确实需要虚拟主机路由，则显式设置它，并确认这是有意的。

func replaceTarget(req *http.Request, target string) (*http.Request, error) {
	// 使用原上下文，保留调用方的取消和截止时间。
	clone, err := cloneTo(req, req.Context(), target)
	if err != nil {
		return nil, err
	}

	// 空 Host 让 net/http 根据 clone.URL.Host 生成 Host 值。
	clone.Host = ""
	// 客户端请求由 URL 生成 request-target，不要把服务端 RequestURI 当结果字段改写。
	clone.RequestURI = ""

	// 需要追加参数时只改副本的 URL 查询，不碰原请求。
	q := clone.URL.Query()
	q.Set("route", "canary")
	clone.URL.RawQuery = q.Encode()
	return clone, nil
}

如果 target 只是路径而不是完整地址，先确认调用者的请求类型：对客户端请求，URL.Host 才是连接目标；对服务端收到的请求，URL 的语义又不同。改址函数最好只接受绝对 URL，减少跨两种语义误用的机会。

确认 Body 能否重复发送

这是最容易被忽略的边界。Clone 不会复制 Body 里的字节；如果先把原请求体读完，再把 clone 交给客户端，副本可能只读到 EOF。GET 或无 Body 请求没有这个问题。对可重建请求体，优先在创建请求时保留 GetBody，发送第二次前取得新的读取器。

func copyBody(req *http.Request) error {
	// GetBody 能为客户端请求生成一份新的 Body，适合重试或多目标发送。
	if req.Body == nil || req.GetBody == nil {
		return nil
	}
	body, err := req.GetBody()
	if err != nil {
		return fmt.Errorf("rebuild request body: %w", err)
	}
	// 只替换副本的 Body；调用方仍负责按 Client/Transport 约定关闭它。
	req.Body = body
	return nil
}

文件流、网络流或自定义流未必能通过 GetBody 重建。此时不要为了“复制请求”而并发复用同一个 Body；可以重新打开文件、把小请求体预读到字节切片后用 bytes.NewReader 重建，或者明确规定该请求只能发送一次。

用一份可复用函数收口调用方决策

把改址逻辑集中在一个函数中，调用方只处理返回的错误和新的请求。下面这个版本不发送请求，因此可以在单元测试里检查原副本 URL、Host、RawQuery 和 Body 策略。

func prepareForward(req *http.Request, target string) (*http.Request, error) {
	// 使用现有上下文，并把可变字段隔离到 clone。
	clone, err := replaceTarget(req, target)
	if err != nil {
		return nil, err
	}
	if clone.Body != nil && clone.GetBody != nil {
		// 重建 Body，避免与已读取的原流共享当前位置。
		if err := copyBody(clone); err != nil {
			return nil, err
		}
	}
	return clone, nil
}

判断结果时抓住四个点：原请求的 URL 没变；副本的 URL 是绝对地址；自定义 Host 是否符合目标服务预期；带 Body 的请求是否拥有可重建策略。满足这四点，再交给 client.Do，改址行为才是可控的。

相关问题

只想换 Context，需要用 Clone 吗？

不需要改其他字段时可用 WithContext；一旦还要改 Header、URL 或切片字段，优先使用 Clone。

改了 clone.URL，原请求会跟着变化吗？

通过 Clone 得到的 URL 是独立副本，替换或修改 clone.URL 不会按同一指针回写原请求。

为什么换了 URL 仍然访问旧域名？

检查 Request.Host 是否继承了旧的自定义 Host；连接目标仍看 URL.Host，但发送的 Host 值可能被 Request.Host 覆盖。

Clone 能不能让 POST Body 自动复制？

不能。Body 只做浅拷贝；需要重发时使用 GetBody、重新打开源文件或预先保存可重复读取的数据。

官方资料：https://pkg.go.dev/net/http#Request.Clone、https://pkg.go.dev/net/http#Request。