net.Listen 返回 net.TCPListener 是因需暴露 TCP 特有方法；必须循环 Accept 否则无响应；conn 是 net.TCPConn，需并发处理并设超时；地址格式须正确；HTTPS 应用 tls.Listen。
net.Listen 为什么返回 *net.TCPListener 而不是 net.Listener？
因为 net.Listen("tcp", addr) 实际返回的是一个实现了 net.Listener 接口的具体类型——*net.TCPListener。它不是“应该”返回接口，而是 Go 的惯用法：函数返回接口，便于替换和测试；但底层具体类型决定了你能调用哪些扩展方法（比如 SetDeadline、File()）。如果你需要访问 TCP 层特有行为（如获取本地端口、设置 keep-alive），得做类型断言：
l, err := net.Listen("tcp", ":8080")
if err != nil {
log.Fatal(err)
}
if tcpL, ok := l.(*net.TCPListener); ok {
// 可以调用 tcpL.Addr(), tcpL.SetKeepAlive(true) 等
}
Listen 后必须显式 Accept 才能收连接，不写会卡住
net.Listen 只是打开监听套接字，不自动接收连接。漏掉 Accept 循环会导致服务启动后无响应，且没有任何错误提示。常见错误写法：
// ❌ 错误：只 Listen，没 Accept
l, _ := net.Listen("tcp", ":8080")
// 程序直接退出或阻塞在某处，连接永远进不来// ✅ 正确：必须循环 Accept
l, _ := net.Listen("tcp", ":8080")
for {
conn, err := l.Accept()
if err != nil {
log.Println("Accept error:", err)
continue
}
go handleConn(conn) // 并发处理
}
- 每个
conn是*net.TCPConn，支持读写和超时控制 - 务必用
go handleConn(conn)或类似方式并发处理，否则一次只能服务一个客户端 - 忘记
defer conn.Close()容易导致文件描述符耗尽
地址字符串格式错误会导致 listen 失败，常见错误包括
net.Listen("tcp", addr) 中的 addr 必须符合 host:port 格式，且 port 不能为 0（除非你明确想让系统分配空闲端口）。以下写法都会失败：
-
"localhost:8080"：在某些系统上可能因 DNS 解析失败而报lookup localhost: no such host，推荐用"127.0.0.1:8080"或":8080" -
":0"虽然合法（系统自动选端口），但后续无法预测绑定端口，调试困难 -
"0.0.0.0:8080"和":8080"等价，都监听所有 IPv4/IPv6 地址；但若只想监听本机，用"127.0.0.1:8080" - 端口被占用时错误是
listen tcp :8080: bind: address already in use，需先lsof -i :8080或netstat -tulpn | grep :8080查杀
Listen 不处理 TLS，HTTPS 需用 tls.Listen 替代
直接用 net.Listen("tcp", ...) 只能提供明文 TCP 连接。如果要支持 HTTPS 或其他 TLS 协议，不能在应用层自己解析 TLS 握手，而应使用 tls.Listen：
cert, err := tls.LoadX509KeyPair("server.crt", "server.key")
if err != nil {
log.Fatal(err)
}
config := &tls.Config{Certificates: []tls.Certificate{cert}}
l, err := tls.Listen("tcp", ":443", config)
if err != nil {
log.Fatal(err)
}
// 后续 Accept 返回的 conn 是 *tls.Conn，可直接 Read/Write
- 混用
net.Listen+ 手动tls.Server(conn, config)是可行的，但多一层包装，容易漏掉Handshake()或超时配置 -
tls.Listen内部已封装了 accept → upgrade 流程，更安全简洁 - HTTP/2 要求 TLS，所以
http.Server.ServeTLS底层也是基于tls.Listen
conn.SetReadDeadline 和 conn.SetWriteDeadline 做合理设置，导致空闲连接长期滞留、连接池打满、甚至被中间设备（如 NAT 网关）静默断连。 
