示例
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
契约
- 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
文件
- NOTES.md
- csx.json
- go.mod
- host_header_test.go
源代码
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.
{"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"}
module sample
go 1.26
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)
}
}