TcpListener.Start()仅开启端口，需配合异步AcceptTcpClientAsync或Task.Run实现并发；Read()返回值必须检查，不可假设读满；务必using释放资源；生产环境应绑定具体IP并排查防火墙拦截。
用 TcpListener 启动监听，但别直接 Start() 就完事
TcpListener 是 C# 基础 TCP 服务入口，但它的 Start() 方法只是打开端口，不处理连接。常见错误是调用 Start() 后就阻塞在 AcceptTcpClient()，导致单连接、无并发、主线程卡死。
正确做法是配合循环 + 异步或线程池：用 BeginAcceptTcpClient 或 AcceptTcpClientAsync（.NET 4.5+）避免阻塞；若用同步方式，至少包一层 Task.Run 处理每个客户端。
-
new TcpListener(IPAddress.Any, 8080)中IPAddress.Any允许所有网卡接入，生产环境建议明确绑定内网 IP（如IPAddress.Parse("192.168.1.10")） - 调用
Start()前务必检查端口是否被占用，否则抛SocketException错误信息为"Only one usage of each socket address (protocol/network address/port) is normally permitted." - .NET Core/.NET 5+ 推荐优先用
TcpListener的异步方法，避免Thread.Start手动管理线程
接收数据时，NetworkStream.Read() 返回值必须检查
很多人写 stream.Read(buffer, 0, buffer.Length) 后直接当「读满」处理，结果一发小包（比如 3 字节）就卡住或解析错乱。TCP 是流式协议，Read() 只保证返回 ≥0 的字节数，0 表示对端关闭连接，其余值都只是本次实际收到的量。
典型错误是把 Read() 当成“等它读够才返回”，其实它只要底层有数据就立刻返回，哪怕只有 1 字节。
- 永远用返回值做边界判断：
int bytesRead = stream.Read(buffer, 0, buffer.Length);，然后只处理buffer[0..bytesRead] - 不要假设一次
Read()能读完一个完整消息——应用层需自己定义分隔符（如\r\n）或长度头（如前 4 字节为 int 消息长度） - 若用
StreamReader包装NetworkStream，注意其ReadLine()在无换行时会阻塞，且不支持超时控制，不如手动解析可靠
客户端断连后，TcpClient 和 NetworkStream 不会自动释放
没显式调用 client.Close() 或 Dispose()，会导致 socket 句柄泄漏、端口处于 TIME_WAIT 状态，大量短连接下很快耗尽可用端口（错误信息： "An operation on a socket could not be performed because the system lacked sufficient buffer space or because a queue was full."）。
尤其在异常路径中（如解析失败、IO 超时），容易漏掉清理逻辑。
- 务必用
using包裹TcpClient和NetworkStream，确保异常时也能释放资源 -
TcpClient.Connected属性不可靠——它只反映上次操作时的状态，不能用来判断当前是否连通；真要探测，得发心跳或捕获Read()返回 0 - 关闭顺序建议：先
stream.Close()（触发 FIN），再client.Close()；或者直接client.Dispose()，它会级联关闭内部流
调试时抓不到包？先关 Windows 防火墙和杀软的网络过滤
本地测试 TcpListener 绑定 127.0.0.1:8080，用 telnet 或 Python 脚本连不上，十有八九不是代码问题，而是系统级拦截。
Windows Defender 防火墙默认阻止未签名程序的入站连接；某些国产杀软（如 360、腾讯电脑管家）会静默劫持 SOCK_STREAM 连接并重定向到自己的代理进程，导致 AcceptTcpClient() 根本收不到请求。
- 临时验证：以管理员身份运行
netsh advfirewall set allprofiles state off关闭防火墙再试 - 用
netstat -ano | findstr :8080查看端口是否真在监听；若显示LISTENING但外部连不上，基本可定位为网络策略拦截 - VS 调试时若用“仅我的代码”模式，可能跳过
SocketException抛出点，建议关闭该选项并启用“引发时中断”
实际部署时最麻烦的往往不是写逻辑，而是端口权限（Linux 需 root 启动 TcpListener API 里，得靠操作系统配置或额外心跳机制兜底。
