CodeSampleX

示例

net/http v1.26.5: http.Request.Header.Set("Host", ...) is silently ignored on the wire, while http.Request.Host sets the transmitted Host header

已验证示例 — golang net/http v1.26.5: http.Request.Header.Set("Host", ...) is silently ignored on the wire, while http.Request.Host sets the transmitted Host…

sha256:2048efa09c0ebc4df90dad050718dc475d765a68f5a3bbd2026f281745225189

本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
2
构建过它的签名密钥
2
声明的环境 go linux x64 go go gomod

验证运行环境

环境 契约 阶段 运行日期
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-17
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

案例

HOW
目标
http.Request.Header.Set("Host", ...) is silently ignored on the wire, while http.Request.Host sets the transmitted Host header
包
符号
  • http.Request
  • http.Client
  • http.Header
环境
go
创建时间
2026-08-17T01:33:06Z

契约

  1. req.Header.Set("Host", ...) does not override the wire Host header sent by http.Client
  2. req.Host overrides the wire Host header sent by http.Client without populating req.Header["Host"]
  3. server handler receives the wire Host in r.Host while r.Header.Get("Host") is empty

文件

  • NOTES.md
  • csx.json
  • go.mod
  • host_header_test.go

下载源代码构件 (tar.gz)

源代码

NOTES.md
A search for known solutions returned samples covering client timeout enforcement during slow response body reads, method-aware mux route matching, and implicit gzip response decoding in `net/http`. This sample targets a different feature interaction: the divergence between `http.Request.Header.Set("Host", ...)` and `http.Request.Host` during request serialization and transmission.

A model or developer expecting `req.Header.Set("Host", "custom.example.com")` to configure the outgoing HTTP `Host` header fails silently with a green build: the header map mutation is accepted in memory, but `net/http` silently drops it on the wire and transmits `req.URL.Host` instead unless `req.Host` is explicitly set.
csx.json
{"case":{"believed":"Setting the Host header via http.Request.Header.Set(\"Host\", ...) overrides the Host header sent on the wire by http.Client.","caseId":"case:sha256:dc2ab23710550758c50c79cedeed7385bc71e315c46136c21c15b0b0c12bc8eb","contract":["req.Header.Set(\"Host\", ...) does not override the wire Host header sent by http.Client","req.Host overrides the wire Host header sent by http.Client without populating req.Header[\"Host\"]","server handler receives the wire Host in r.Host while r.Header.Get(\"Host\") is empty"],"goal":"http.Request.Header.Set(\"Host\", ...) is silently ignored on the wire, while http.Request.Host sets the transmitted Host header","kind":"HOW","packages":["pkg:golang/net/http@1.26.5"],"schemaVersion":1,"symbols":["http.Request","http.Client","http.Header"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"gomod","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/net/http@1.26.5"],"schemaVersion":1,"symbols":["http.Request","http.Client","http.Header"],"verifierAdapter":"golang@1"}
go.mod
module sample

go 1.26
host_header_test.go
package sample_test

import (
	"bufio"
	"bytes"
	"net/http"
	"net/http/httptest"
	"testing"
)

// TestHostHeaderIgnoredInRequestHeader proves that setting "Host" in req.Header
// is completely ignored by net/http during serialization. The wire request uses
// req.URL.Host (or req.Host) instead of req.Header.Get("Host").
func TestHostHeaderIgnoredInRequestHeader(t *testing.T) {
	req, err := http.NewRequest("GET", "http://example.com/api", nil)
	if err != nil {
		t.Fatalf("failed to create request: %v", err)
	}

	// Developer attempts to set Host via Header map
	req.Header.Set("Host", "custom.example.com")

	if req.Header.Get("Host") != "custom.example.com" {
		t.Fatalf("expected client in-memory req.Header.Get(\"Host\") to be \"custom.example.com\", got %q", req.Header.Get("Host"))
	}

	// Serialize request to wire format
	var wireBuf bytes.Buffer
	if err := req.Write(&wireBuf); err != nil {
		t.Fatalf("req.Write failed: %v", err)
	}

	// Parse back the wire format as a server would receive it
	parsedReq, err := http.ReadRequest(bufio.NewReader(&wireBuf))
	if err != nil {
		t.Fatalf("http.ReadRequest failed: %v", err)
	}

	// Disproves believed: req.Header.Set("Host", ...) had NO effect on the wire Host header.
	if parsedReq.Host == "custom.example.com" {
		t.Fatalf("req.Header.Set(\"Host\", ...) unexpectedly set wire Host")
	}
	if parsedReq.Host != "example.com" {
		t.Fatalf("expected wire Host to be \"example.com\" (from URL.Host), got %q", parsedReq.Host)
	}
	if parsedReq.Header.Get("Host") != "" {
		t.Fatalf("expected parsedReq.Header.Get(\"Host\") to be empty, got %q", parsedReq.Header.Get("Host"))
	}
}

// TestHostFieldOverridesWireHost proves that setting req.Host directly
// controls the wire Host header without populating req.Header["Host"].
func TestHostFieldOverridesWireHost(t *testing.T) {
	req, err := http.NewRequest("GET", "http://example.com/api", nil)
	if err != nil {
		t.Fatalf("failed to create request: %v", err)
	}

	// Correct mechanism: set struct field req.Host
	req.Host = "custom.example.com"

	if req.Header.Get("Host") != "" {
		t.Fatalf("expected req.Header.Get(\"Host\") to remain empty, got %q", req.Header.Get("Host"))
	}

	var wireBuf bytes.Buffer
	if err := req.Write(&wireBuf); err != nil {
		t.Fatalf("req.Write failed: %v", err)
	}

	parsedReq, err := http.ReadRequest(bufio.NewReader(&wireBuf))
	if err != nil {
		t.Fatalf("http.ReadRequest failed: %v", err)
	}

	if parsedReq.Host != "custom.example.com" {
		t.Fatalf("expected wire Host to be \"custom.example.com\", got %q", parsedReq.Host)
	}
	if parsedReq.Header.Get("Host") != "" {
		t.Fatalf("expected parsedReq.Header.Get(\"Host\") to be empty on server, got %q", parsedReq.Header.Get("Host"))
	}
}

// TestClientDoHostHeaderInteraction proves the end-to-end behavior across http.Client
// and http.Server: req.Header.Set("Host", ...) does not affect server r.Host,
// req.Host correctly overrides server r.Host, and server r.Header.Get("Host") is always empty.
func TestClientDoHostHeaderInteraction(t *testing.T) {
	var receivedHost string
	var receivedHeaderHost string

	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		receivedHost = r.Host
		receivedHeaderHost = r.Header.Get("Host")
		w.WriteHeader(http.StatusOK)
	}))
	defer server.Close()

	client := server.Client()

	// 1. Sending with req.Header.Set("Host", ...)
	req1, err := http.NewRequest("GET", server.URL, nil)
	if err != nil {
		t.Fatalf("failed to create request: %v", err)
	}
	req1.Header.Set("Host", "custom.example.com")

	resp1, err := client.Do(req1)
	if err != nil {
		t.Fatalf("client.Do failed: %v", err)
	}
	resp1.Body.Close()

	if receivedHost == "custom.example.com" {
		t.Fatalf("req.Header.Set(\"Host\", ...) unexpectedly set server r.Host")
	}
	if receivedHeaderHost != "" {
		t.Fatalf("expected server r.Header.Get(\"Host\") to be empty, got %q", receivedHeaderHost)
	}

	// 2. Sending with req.Host
	req2, err := http.NewRequest("GET", server.URL, nil)
	if err != nil {
		t.Fatalf("failed to create request: %v", err)
	}
	req2.Host = "custom.example.com"

	resp2, err := client.Do(req2)
	if err != nil {
		t.Fatalf("client.Do failed: %v", err)
	}
	resp2.Body.Close()

	if receivedHost != "custom.example.com" {
		t.Fatalf("expected server r.Host to be \"custom.example.com\", got %q", receivedHost)
	}
	if receivedHeaderHost != "" {
		t.Fatalf("expected server r.Header.Get(\"Host\") to be empty, got %q", receivedHeaderHost)
	}
}

原始种子者

csx-seed