Golang如何实现简单的TCP服务器

来源:IPIPP.com作者:头衔:全栈工程师
导读:本期聚焦于小伙伴创作的《Golang如何实现简单的TCP服务器》,敬请观看详情,探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《Golang如何实现简单的TCP服务器》有用,将其分享出去将是对创作者最好的鼓励。

TCP服务器是网络编程中非常基础的应用场景,Golang凭借简洁的语法和原生支持的并发特性,实现TCP服务器会比很多其他语言更简单高效。下面我们就一步步实现这个需求。

Golang如何实现简单的TCP服务器

实现核心思路

Golang的标准库net包封装了TCP相关的底层操作,实现简单TCP服务器的核心流程可以分为三步:

  • 使用net.Listen函数在指定端口启动TCP监听,等待客户端连接
  • 循环调用监听器的Accept方法接收客户端连接,每个连接会返回一个net.Conn对象
  • 针对每个连接启动独立的goroutine处理通信逻辑,避免阻塞主监听流程

完整实现代码

下面是可直接运行的简单TCP服务器代码,实现了接收客户端消息并原样返回的功能:

package main

import (
	"fmt"
	"net"
	"bufio"
	"strings"
)

func main() {
	// 监听本地8080端口,协议为TCP
	listener, err := net.Listen("tcp", "127.0.0.1:8080")
	if err != nil {
		fmt.Println("启动监听失败:", err)
		return
	}
	defer listener.Close()
	fmt.Println("TCP服务器已启动,监听地址: 127.0.0.1:8080")

	// 循环接收客户端连接
	for {
		conn, err := listener.Accept()
		if err != nil {
			fmt.Println("接收连接失败:", err)
			continue
		}
		// 启动goroutine处理当前连接,实现并发
		go handleConn(conn)
	}
}

// 处理单个客户端连接的函数
func handleConn(conn net.Conn) {
	// 函数退出时关闭连接
	defer conn.Close()
	// 创建带缓冲的读取器,按行读取客户端消息
	reader := bufio.NewReader(conn)
	fmt.Println("新客户端连接:", conn.RemoteAddr())

	for {
		// 读取客户端发送的消息,直到遇到换行符
		msg, err := reader.ReadString('\n')
		if err != nil {
			fmt.Println("客户端断开连接:", conn.RemoteAddr(), err)
			return
		}
		// 去除消息两端的空白字符
		msg = strings.TrimSpace(msg)
		fmt.Printf("收到客户端 %s 的消息: %s\n", conn.RemoteAddr(), msg)

		// 给客户端返回响应,原样返回收到的消息
		response := fmt.Sprintf("服务器已收到: %s\n", msg)
		_, err = conn.Write([]byte(response))
		if err != nil {
			fmt.Println("发送响应失败:", err)
			return
		}
	}
}

代码关键部分说明

监听端口

net.Listen的第一个参数指定网络协议为tcp,第二个参数是监听的地址,这里使用127.0.0.1:8080表示只监听本地回环地址的8080端口,如果需要允许外部访问可以改成:8080表示监听所有网卡。

并发处理连接

每次调用listener.Accept()获取到新连接后,使用go handleConn(conn)启动新的goroutine处理,这样主流程不会被单个连接的阻塞操作卡住,可以同时处理多个客户端的请求,这是Golang实现高并发TCP服务的核心优势。

连接数据处理

这里使用bufio.Reader按行读取客户端消息,实际开发中可以根据需求调整读取逻辑,比如读取固定长度的字节、使用自定义的协议分隔符等。处理完通信后一定要调用conn.Close()关闭连接,释放资源。

测试验证

运行上面的代码后,可以使用系统自带的telnet工具测试服务器功能:

# 打开终端输入以下命令连接服务器
telnet 127.0.0.1 8080
# 连接成功后输入任意内容按回车,就能收到服务器的响应

注意事项

  • 实际生产环境中需要添加更完善的错误处理,比如监听端口被占用、客户端异常断开等场景的处理
  • 如果处理大量并发连接,需要注意goroutine的数量控制,避免资源耗尽,可以结合连接池或者限流机制
  • 如果需要传输二进制数据,不要用按行读取的方式,要改用Read方法读取指定长度的字节数组
  • 服务器退出时要确保所有的连接都正确关闭,避免客户端出现连接泄漏问题

GolangTCP服务器net包goroutine并发处理修改时间:2026-06-02 16:03:03

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。