Python 网络编程常见问题总结

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 行为，大部分网络问题都能快速定位。