Python网络编程常见坑包括：socket默认阻塞需设超时；recv()不保证收全数据须拼包；中文需统一UTF-8编解码；socket非线程安全应独占使用。
Python 网络编程中，很多问题并非语法错误，而是对底层协议、IO 模型或库行为理解偏差导致的。以下是最常踩的几类坑，覆盖阻塞与非阻塞、连接管理、编码处理和并发模型等核心场景。
socket 默认是阻塞的，不设超时容易卡死
创建 socket 后若不显式设置 settimeout()，connect()、recv()、send() 都会无限等待。尤其在不可达地址或对方无响应时，整个线程就挂住了。
- 客户端发起连接前，建议统一加超时：
s.settimeout(5)（单位秒） - 服务端
accept()也需设超时，否则while True: s.accept()可能永久阻塞 - 临时取消阻塞可用
s.setblocking(False)，但后续操作需配合异常捕获（如BlockingIOError）或使用select/poll
recv() 不保证一次性收完所有数据
TCP 是流式协议，recv(n) 最多返回 n 字节，可能远少于预期，甚至返回空字节（对端关闭连接）。常见错误是假定一次 recv(1024) 就能拿到完整报文。
- 应用层需自行拼包：循环调用
recv()直到收到完整消息（例如按长度头解析，或遇到特定分隔符如\n） - 不要依赖
recv(1024)的“1024”语义——它只是缓冲区上限，不是每次必收满 - 服务端读取时务必检查返回值：空 bytes 表示连接已关闭，应主动
close()
中文乱码本质是编码没对齐
网络传输只认字节，字符串必须 encode 成 bytes 才能 send；接收的 bytes 也必须 decode 才能转回字符串。常见错误是发送用 utf-8，接收却用 gbk 解码，或忘记 encode/decode 直接传 str 给 send() 导致 TypeError。
立即学习“Python免费学习笔记（深入）”；
- 约定好通信双方的编码格式（推荐 UTF-8），并在所有 send/recv 处显式转换
- HTTP 场景下注意响应头中的
Content-Type: text/html; charset=utf-8，requests 库通常自动处理，但 raw socket 需手动解析 - 调试时可用
data.hex()查看原始字节，避免被 print 的隐式解码误导
多线程/多进程下 socket 共享易出错
socket 对象本身不是线程安全的。多个线程同时调用同一 socket 的 send() 或 recv() 可能导致数据错乱、异常中断，甚至引发 Bad file descriptor 错误。
- 每个线程应持有独立 socket（如客户端连接后交由单一线程独占处理）
- 服务端主线程 accept() 后，立即把新 socket 交给新线程/进程，原 socket 不再参与该连接通信
- 若需跨线程传递数据，用
queue.Queue等线程安全结构中转，而非共享 socket 实例
不复杂但容易忽略。抓住协议特性、明确字节边界、控制 IO 行为，大部分网络问题都能快速定位。
