Go httputil.ReverseProxy无法覆盖Host头问题排查

我太懂你这个头疼的问题了——明明在Director和自定义RoundTripper里反复设置Host头为nghttp2.org，但后端收到的还是localhost:8080，连mitmproxy抓包都显示HTTP/2的:authority伪头也是这个原始值。

问题根源 #

问题出在Go的net/http包的底层逻辑上：

• 对于HTTP/1请求，Request.Host字段的优先级高于req.Header.Get("Host")，传输时会直接用Request.Host生成Host头
• 对于HTTP/2请求，:authority伪头完全由Request.Host字段决定，Header里的Host设置会被直接忽略

你之前只修改了req.Header.Set("Host")，但没同步更新req.Host字段，所以这个字段默认保留了原始请求的localhost:8080，最终被传输到后端。

解决方案 #

只需要在Director函数（或者自定义RoundTripper里）同时设置req.Host字段，就能彻底覆盖原始Host值，不管是HTTP/1还是HTTP/2请求都能生效。

修改后的代码如下：

package main

import (
	"log"
	"net/http"
	"net/http/httputil"
)

func main() {
	proxy := &httputil.ReverseProxy{
		Transport: roundTripper(rt),
		Director: func(req *http.Request) {
			req.URL.Scheme = "https"
			req.URL.Host = "nghttp2.org"
			req.URL.Path = "/httpbin" + req.URL.Path
			req.Header.Set("Host", "nghttp2.org")
			req.Host = "nghttp2.org" // <--- 关键新增：设置Request.Host字段
		},
	}
	log.Fatal(http.ListenAndServe(":8080", proxy))
}

func rt(req *http.Request) (*http.Response, error) {
	log.Printf("request received. url=%s", req.URL)
	// 这里其实可以不用重复设置Header了，Director里已经处理到位
	defer log.Printf("request complete. url=%s", req.URL)
	return http.DefaultTransport.RoundTrip(req)
}

// roundTripper 转换函数签名为http.RoundTripper
type roundTripper func(*http.Request) (*http.Response, error)

func (f roundTripper) RoundTrip(req *http.Request) (*http.Response, error) {
	return f(req)
}

验证效果 #

现在执行curl localhost:8080/get，后端返回的响应会显示正确的Host值：

{
  "headers": {
    "Accept": "*/*",
    "Accept-Encoding": "gzip",
    "Host": "nghttp2.org",
    "User-Agent": "curl/7.54.0"
  },
  "origin": "2601:602:9c02:16c2:fca3:aaab:3914:4a71",
  "url": "https://nghttp2.org/httpbin/get"
}

同时mitmproxy抓包也会看到:authority伪头被正确设置为nghttp2.org。

补充说明 #

• req.Host是Go HTTP客户端/传输层确定目标Host的核心字段，Header里的Host只是“表象”，最终传输时会被req.Host覆盖
• 虽然在自定义RoundTripper里修改也能生效，但更推荐在Director里完成所有请求重写——毕竟这是httputil.ReverseProxy设计用来处理这类逻辑的地方

内容的提问来源于stack exchange，提问作者ahmet alp balkan