Go语言实现TCP客户端发送请求并接收服务器响应的完整方法

沈知远

发布时间：2026-10-14| 6人浏览过

原创

在Go语言服务器开发或网络编程中，客户端向服务器发送数据并接收返回结果是基础且核心的操作。本文将介绍如何利用Go的标准库net和io实现一个简单的TCP客户端，完成从创建连接到发送HTTP GET请求，再到接收并打印响应内容的完整过程。

核心目标与原理

本示例的目标是模拟一个基础的HTTP客户端行为：连接指定的远程主机（如Apache官网），发送标准的GET请求头，然后持续读取服务器返回的HTML数据直到连接结束。主要依赖以下标准库组件：

net：提供Dial函数用于建立TCP连接。
io：提供WriteString函数方便地写入字符串数据。
bufio或手动Buffer：用于高效读取大量响应数据。

第1步：定义连接参数与准备缓冲区

首先，需要确定要连接的服务器地址和端口，并创建一个足够大的字节切片作为数据缓冲区。这一步的目的是明确通信目标和数据存储位置。

package main

import (
	"fmt"
	"io"
	"net"
)

在main函数或独立功能函数中初始化变量：

host：目标主机名，例如 "www.apache.org"。
port：服务端口，HTTP通常为 "80"。
remote：组合后的完整地址字符串。
msg：发送的请求内容，此处为简化的 HTTP GET 请求。
data：长度为4096的字节切片，用于暂存接收到的数据。

第2步：建立TCP连接

使用net.Dial发起TCP连接。这是网络通信的第一步，若网络不通或服务端未响应，此步骤将返回错误。务必检查err以确保连接成功。

// create the socket
conn, err := net.Dial("tcp", remote)
if err != nil {
    fmt.Println("连接失败:", err)
    return
}

第3步：发送请求数据

连接建立后，通过io.WriteString向连接对象发送字符串数据。该方法底层会自动将字符串转换为字节流写入网络连接。对于TCP协议，数据发送后即进入服务端处理队列。

// send our message. an HTTP GET request in this case
io.WriteString(conn, msg)
// 或者直接使用 conn.Write([]byte(msg))

第4步：循环读取响应

这是关键步骤。由于HTTP响应可能包含大量数据（如HTML页面、图片等），一次Read调用可能无法读尽所有数据。因此需要使用for循环不断读取，直到检测到EOF（End of File）或出现非预期错误。

for {
	count, err := conn.Read(data)
	if count > 0 {
		// 仅打印有效读取的数据部分，避免输出空字节
		fmt.Printf(string(data[:count]))
	}
	if err != nil {
		break // 通常遇到 io.EOF 表示读取完毕
	}
}

第5步：关闭连接与资源清理

无论读取是否正常结束，都必须调用conn.Close()释放操作系统层面的文件描述符和网络资源。这能防止资源泄漏，尤其是在长期运行的服务中至关重要。

完整可运行代码

以下是整合上述步骤的完整代码片段，可直接复制保存为client.go进行编译运行。注意：确保本地环境变量允许访问外网。

package mysocket

import (
	"fmt"
	"io"
	"net"
)

func MySocketBase() {
	var (
		host   = "www.apache.org"
		port   = "80"
		remote = host + ":" + port
		msg    = "GET / HTTP/1.1\r\nHost: www.apache.org\r\n\r\n" // 补全标准HTTP头部以符合规范
		data   = make([]uint8, 4096)
		count  = 0
	)

	// 1. 创建TCP连接
	conn, err := net.Dial("tcp", remote)
	if err != nil {
		fmt.Println("Dial error:", err)
		return
	}
	defer conn.Close() // 确保函数退出时自动关闭连接

	// 2. 发送请求
	io.WriteString(conn, msg)

	// 3. 接收并打印响应
	for {
		count, err = conn.Read(data)
		if count > 0 {
			fmt.Print(string(data[:count]))
		}
		if err != nil {
			// err == io.EOF 是正常的读取结束信号
			break
		}
	}
}

注意事项与排错

HTTP协议规范：原文中的请求头 "GET/ \n" 较为简陋。在实际生产环境中，建议发送符合RFC标准的HTTP/1.1请求，包括完整的Host头和空的结束行（\r\n\r\n），否则某些严格的服务端可能会拒绝或响应异常。
缓冲大小限制：示例中使用4096字节的缓冲区。如果响应极大，循环会多次触发读写，这是正常现象。不要试图一次性分配极大内存来存储整个响应。
超时设置：net.Dial默认没有超时机制。在网络不稳定环境下，可能导致程序挂起。建议使用net.Dialer配置Timeout字段来提升健壮性。