多线程TCP文件传输服务器异常问题排查求助

可能的问题原因 #

• 共享资源竞态条件：服务器端若存在全局/共享的进度计数器、文件指针、文件句柄等资源，多线程未加同步保护就直接读写，会导致：
  • 进度计数器被多线程交替修改，统计值失真，出现两端进度百分比不一致；
  • 文件写入指针被并发修改，导致数据写入位置混乱（重叠、跳过），最终文件损坏。
• TCP字节流的多线程处理错误：若对同一个TCP连接使用多个线程调用recv，TCP的字节流特性会让多个线程各自读取部分数据，线程间无法保证数据的顺序拼接，导致写入文件的数据顺序错乱、缺失。
• 线程同步与生命周期问题：子线程未完成数据接收/写入就被提前终止，或主线程在子线程未结束时关闭文件、套接字，造成数据截断；进度统计时未使用原子操作，累加操作被线程打断，统计值错误。
• 数据块处理逻辑缺陷：多线程环境下错误假设recv能完整接收预设大小的数据块，未处理recv返回的实际字节数小于预期的情况，导致数据拼接错误。

排查与解决步骤 #

1. 验证文件完整性：计算原文件与接收文件的MD5哈希值，若不一致，说明数据传输/写入环节存在错误；若一致仅进度显示异常，聚焦进度统计的竞态问题。
2. 检查共享资源访问逻辑：
   • 排查所有多线程共享的变量（计数器、文件句柄、套接字等），确认是否加了同步锁（如pthread_mutex_t、std::mutex）；
   • 若为单TCP连接多线程处理，立刻改为单线程处理该连接的数据流——TCP字节流不适合多线程并发读取，多线程服务器应采用“一个连接对应一个线程”的模型，而非一个连接用多线程处理。
3. 添加同步机制测试：给文件写入、进度统计的代码块加互斥锁，若问题消失，即可确认是竞态条件导致的问题。
4. 调试数据传输顺序：在客户端发送的每个数据块头部添加序号和长度，服务器端接收后校验序号连续性，排查是否存在数据缺失、顺序颠倒的情况，定位线程间数据拼接的问题。
5. 修正进度统计逻辑：将进度计数器改为原子类型（如C++的std::atomic<size_t>），或在累加操作时加锁，避免多线程同时修改导致的统计错误。
6. 确认线程生命周期：主线程需通过pthread_join（POSIX）或std::thread::join()（C++）等待所有子线程完成数据处理后，再关闭文件和套接字，避免数据截断。

内容的提问来源于stack exchange，提问作者MeoH