如何在 Go 中使用 net 包正确发送 HTTP POST 请求

本文详解使用 Go 标准库 net 包手动构造 HTTP POST 请求时的常见错误——缺失 Content-Length 或未关闭写入流导致服务器无法接收数据，并提供两种可靠解决方案。

本文详解使用 Go 标准库 net 包手动构造 HTTP POST 请求时的常见错误——缺失 Content-Length 或未关闭写入流导致服务器无法接收数据，并提供两种可靠解决方案。

在 Go 里，跳过 net/http、直接用底层 net 包去发 HTTP 请求，这件事本身确实有教学意义，也很适合拿来做调试。不过话说回来，这样做也特别容易踩坑，因为只要把 HTTP 协议里的细节漏掉一点，请求就可能直接失败。你给出的这段代码表面上很简练，问题却恰恰出在这里：它实际上违背了 HTTP/1.0 的一条基本约定——服务器只有在明确知道请求体长度时，才能判断请求什么时候结束，并开始后续处理。

你的原始代码存在两个关键问题：

1. 缺少 Content-Length 请求头：HTTP/1.0 默认不启用分块传输（chunked encoding），因此必须显式声明请求体字节数，否则服务器将持续等待更多数据（直至连接超时或 EOF）；
2. 未关闭写入端（write half-close）：调用 conn.Write() 后，TCP 连接仍处于“可读可写”状态，服务器无法感知客户端已发送完毕，因而阻塞在读取阶段。

✅ 正确做法有两种，任选其一即可：

✅ 方案一：添加 Content-Length 头（推荐用于可控、定长数据）

conn, err := net.Dial("tcp", "127.0.0.1:80")
if err != nil {
log.Fatal(err)
}
defer conn.Close()

data := []byte("ABCDEFGHIJ")
req := fmt.Sprintf(
"POST /handleupload.php HTTP/1.0rn"+
"Host: 127.0.0.1rn"+
"Content-Length: %drn"+
"rn",
len(data),
)

if _, err := io.WriteString(conn, req); err != nil {
log.Fatal(err)
}
if _, err := conn.Write(data); err != nil {
log.Fatal(err)
}

// 读取响应（注意：应读取完整 HTTP 响应，而非等待 'z' 字符）
resp, err := io.ReadAll(conn)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(resp))

⚠️ 注意：Host 头虽非 HTTP/1.0 强制要求，但现代 PHP 服务器（如 Apache/Nginx）通常依赖它路由请求；Content-Length 必须精确匹配实际字节数。

✅ 方案二：调用 CloseWrite() 显式终止写入流（适用于流式或未知长度场景）

conn, err := net.Dial("tcp", "127.0.0.1:80")
if err != nil {
log.Fatal(err)
}
defer conn.Close()

fmt.Fprintf(conn, "POST /handleupload.php HTTP/1.0rnrn")
data := []byte("ABCDEFGHIJ")
conn.Write(data)

// 关键：通知服务器写入完成（触发 TCP FIN）
if tcpConn, ok := conn.(*net.TCPConn); ok {
tcpConn.CloseWrite() // 或使用更通用的：conn.(interface{ CloseWrite() error }).CloseWrite()
} else {
log.Fatal("not a TCPConn")
}

// 读取响应（避免 ReadString('z') —— 可能永远阻塞）
resp, err := io.ReadAll(conn)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(resp))

? 补充说明与最佳实践

• bufio.NewReader(conn).ReadString('z') 是严重隐患：若响应中不含 'z'，该调用将无限期阻塞。应改用 io.ReadAll() 或按 HTTP 协议解析响应头+正文；
• HTTP/1.1 更推荐使用 net/http 客户端（自动处理头、重定向、连接复用等），仅在学习协议或嵌入式受限场景才需手写；
• 手动构造 HTTP 时，务必遵守 RFC 7230：请求行、头部以 rn 结尾，头尾空行分隔，正文紧随其后。

掌握这些底层细节，不仅能修复上传失败问题，更能加深对网络协议栈的理解——这正是 net 包存在的意义。