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 更方便。
立即学习“go语言免费学习笔记（深入）”；
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。
IPv6双栈监听依赖操作系统和Go版本
使用 ":8080" 在大多数现代系统上默认启用 IPv6 双栈（即同时监听 IPv4 和 IPv6），但前提是：
- Linux 内核开启
net.ipv6.bindv6only = 0（默认值，允许 IPv6 socket 接收 IPv4 连接） - Go 1.11+ 默认启用双栈；旧版本需手动设置
net.ListenConfig{Control: ...} - Windows 上需确保 IPv6 协议已启用
验证是否生效：启动服务后运行 ss -tln | grep :8080，若看到 *:8080 或 :::8080 表示双栈正常；若只看到 127.0.0.1:8080，说明绑定受限。
如果明确只要 IPv4，写死 "0.0.0.0:8080"；只要 IPv6，写 "[::]:8080"。别依赖 localhost 或未指定 IP 的模糊写法来控制协议族。
