Python Socket实现文件下载时客户端无法接收服务器返回的数据

现存核心代码错误点 #

1. 二进制流与字符串编码的类型不匹配 #

• 服务器端读取文件用rb模式，返回的内容是原生二进制（bytes类型），但代码中强行对二进制内容调用.encode(FORMAT)方法。bytes类型不存在encode方法，代码执行到这行直接触发AttributeError崩溃，发送循环从第一帧就中断，根本没有把文件数据推到网络上。
• 客户端写文件用wb模式，要求写入的是二进制内容，但代码中把接收到的网络数据解码成字符串后再写入，就算服务器能发数据，也会因为类型不匹配导致写入失败。

对应错误代码段：

# 服务器端错误逻辑
l = f.read(1024) # l是bytes类型
conn.send(l.encode(FORMAT)) # 对bytes调用encode，直接抛异常

2. 传输流程缺少结束标记，导致recv永久阻塞 #

• 当前逻辑依赖recv()返回空值判断传输结束，而返回空值的前提是服务器端主动关闭socket连接。但现有代码读完文件后只关闭了文件句柄，既没有发送明确的传输完成标识，也没有关闭连接，客户端会一直卡在client.recv(1024)的等待状态，无法退出循环，也就不会执行后续的写入和打印操作。

3. 打印语句语法错误 #

• 客户端代码中print("Data: %s", (data))的写法，会将格式字符串和数据作为两个独立参数传给打印函数，就算收到数据也无法正常格式化输出内容。

修复后的参考实现 #

服务器端DOWN分支修正代码 #

elif cmd == "DOWN":
    recv_filename = conn.recv(1024).decode(FORMAT)
    # 用上下文管理器自动处理文件句柄关闭
    with open(f"server/{recv_filename}", 'rb') as src_f:
        while True:
            chunk = src_f.read(1024)
            if not chunk:
                # 文件读取完成，发送结束标识
                conn.sendall(b"TRANSFER_END")
                break
            # 直接发送二进制数据块，无需额外编码
            conn.sendall(chunk)
    print("done sending")

客户端DOWN分支修正代码 #

elif cmd == "DOWN":
    filename = data[1]
    print(filename)
    client.send(filename.encode(FORMAT))
    with open(f"client/{filename}", 'wb') as dst_f:
        while True:
            print("receiving data")
            # 直接接收二进制流，不做字符串解码
            chunk = client.recv(1024)
            # 匹配结束标识，退出循环
            if chunk == b"TRANSFER_END":
                break
            dst_f.write(chunk)
            print(f"已写入数据块，大小：{len(chunk)} 字节")
    print("文件接收完成")

快速验证定位方法 #

• 打开服务器端的运行控制台，查看是否有未捕获的异常堆栈。当前场景下服务器大概率在第一帧发送时就因为类型错误崩溃，没有走到发送循环的打印逻辑，因此客户端收不到任何网络数据。
• 临时在服务器的发送循环入口加断点或打印语句，确认是否能进入循环读取文件内容，排除目标文件不存在、路径错误导致读不到内容的问题。

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