Go语言如何监听TCP端口_net Listen基础用法_技术教程

net.Listener必须手动调用Close()释放资源；监听地址如":8080"支持双栈，"127.0.0.1:8080"限本机；Accept无内置超时，需select+time.After实现；IPv6双栈依赖系统配置与Go版本。

Listen函数返回的`net.Listener`必须手动关闭

Go 的 net.Listen 不会自动管理连接生命周期，它只负责监听端口并返回一个 net.Listener 接口。如果你在 main 函数里调用后直接退出，或者忘记调用 Close()，系统资源（如文件描述符、端口绑定）可能

不会立即释放，尤其在开发中反复启停服务时容易遇到 address already in use 错误。

常见写法误区是只关注 Accept() 循环，却忽略 defer listener.Close() 或未做异常兜底：

listener, err := net.Listen("tcp", ":8080")
if err != nil {
    log.Fatal(err)
}
defer listener.Close() // 必须加，且要放在 Accept 循环之前
for {
conn, err := listener.Accept()
if err != nil {
// 注意：某些错误（如 syscall.EINVAL）可能表示 listener 已关闭，应跳出循环
log.Println("Accept error:", err)
break
}
go handleConnection(conn)
}

监听地址字符串格式影响绑定范围

net.Listen("tcp", addr) 中的 addr 参数决定服务是否对外可访问。常见写法有：

":8080" → 绑定到所有本地 IPv4/IPv6 地址（等价于 0.0.0.0:8080 或 [::]:8080），外部机器能访问
"127.0.0.1:8080" → 仅绑定 IPv4 回环，只有本机进程能连
"[::1]:8080" → 仅绑定 IPv6 回环
"localhost:8080" → 取决于 DNS 解析结果，不推荐；可能只解析出 IPv4 或 IPv6，行为不确定

生产环境若需限制访问范围，优先显式写 127.0.0.1:port；调试时用 :port 更方便。

Accept阻塞与超时控制需额外处理

listener.Accept() 默认是阻塞调用，没有内置超时机制。如果想实现“等待连接最多 5 秒，超时则检查健康状态”，不能靠 SetDeadline（它属于 conn，不是 listener），而得用带超时的 channel 或 net.ListenConfig 配合 context。

简单方案：用 time.AfterFunc 或 select + time.After 实现非阻塞轮询（适合轻量场景）：

listener, _ := net.Listen("tcp", ":8080")
defer listener.Close()
for {
select {
case <-time.After(5 * time.Second):
log.Println("No connection in 5s, doing health check...")
continue
default:
conn, err := listener.Accept()
if err != nil {
if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
continue
}
log.Println("Accept failed:", err)
break
}
go handleConnection(conn)
}
}

注意：net.Listener 本身不支持 SetDeadline，别试图对它调用该方法——会 panic。