本文详解如何使用 Go 实现单连接下多文件的有序传输：服务端先读取文件数量，再循环接收每个文件名与大小，最后按指定字节数精确读取内容，避免 io.Copy 读取越界；同时提供基于 HTTP multipart 的更健壮替代方案。
本文详解如何使用 go 实现单连接下多文件的有序传输：服务端先读取文件数量，再循环接收每个文件名与大小，最后按指定字节数精确读取内容，避免 `io.copy` 读取越界；同时提供基于 http multipart 的更健壮替代方案。
在 Go 中通过原始 TCP 连接传输多个文件时，核心挑战在于流式协议缺乏天然的消息边界。你遇到的 io.Copy “吃掉后续文件数据”问题，本质是它会持续读取直到连接关闭（EOF），而你的协议设计却期望在同一连接上分段传输多个独立文件。解决的关键在于：显式声明每段数据的长度，并严格按长度截断读取。
✅ 正确的 TCP 多文件传输协议设计
推荐采用如下轻量级自定义协议（无需额外依赖）：
- 客户端首先发送文件总数（换行结尾）；
- 对每个文件：
- 发送文件名（换行结尾）；
- 发送文件字节长度（换行结尾）；
- 发送对应长度的原始文件字节流。
服务端严格遵循该顺序解析，使用 bufio.Reader 读取文本元信息，用 io.CopyN 精确读取二进制内容。
以下是修复后的完整服务端示例（含错误处理与资源安全）：
func getFileFromClient(conn net.Conn) {
defer conn.Close() // 确保连接最终关闭
r := bufio.NewReader(conn)
// 1. 读取文件总数
line, err := r.ReadString('\n')
if err != nil {
fmt.Printf("读取文件总数失败: %v\n", err)
return
}
countStr := strings.TrimSpace(line)
fileCount, err := strconv.Atoi(countStr)
if err != nil || fileCount <blockquote>
<p>⚠️ <strong>关键修正说明</strong>：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/learn/7564" title="使用Go语言搭建家庭相册系统-相关课件"><img
src="https://img.php.cn/upload/webcode/000/000/164/636a2b4d84031727.png" alt="使用Go语言搭建家庭相册系统-相关课件" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/learn/7564" title="使用Go语言搭建家庭相册系统-相关课件" class="overflowclass">使用Go语言搭建家庭相册系统-相关课件</a>
<p class="overflowclass">使用Go语言搭建家庭相册系统-相关课件</p>
</div>
<a rel="nofollow" href="/xiazai/learn/7564" title="使用Go语言搭建家庭相册系统-相关课件" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>io.CopyN(f, r, fileSize)：<strong>必须从 bufio.Reader r 而非原始 conn 读取</strong>。因为文件名、大小等元数据已由 r.ReadString() 消费，其内部缓冲区已包含后续文件数据。若直接读 conn，会跳过缓冲区，导致数据错位。</li>
<li>defer f.Close() 在循环中不安全（可能覆盖前次句柄），应显式调用 f.Close()。</li>
<li>所有错误分支均提前返回，避免状态混乱。</li>
</ul>
</blockquote><h3>? 更推荐的方案：使用 HTTP + Multipart</h3><p>尽管 TCP 方案可行，但生产环境强烈建议迁移到标准 HTTP 协议——它天然支持多文件、流式上传、进度反馈、超时控制及成熟客户端生态（如 curl、Postman、前端 FormData）。</p><p>服务端仅需几行代码：</p><pre class="brush:php;toolbar:false;">func uploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持 POST", http.StatusMethodNotAllowed)
return
}
// 解析 multipart 表单
err := r.ParseMultipartForm(32 <p>客户端可使用 curl 快速测试：</p><pre class="brush:php;toolbar:false;">curl -X POST http://localhost:8080/upload \
-F "files=@photo1.jpg" \
-F "files=@photo2.png" \
-F "files=@doc.pdf"✅ 总结与最佳实践
- TCP 自定义协议适用场景：嵌入式、IoT 或对延迟/带宽有极致要求且无法引入 HTTP 栈的场景。务必严格遵循“长度前缀”模式，杜绝 io.Copy 在非 EOF 边界使用。
- HTTP Multipart 是默认首选：协议标准化、工具链完善、天然支持断点续传、权限控制、反向代理集成，且 Go 标准库 mime/multipart 实现健壮无坑。
- 安全提醒：生产环境需校验文件名（防止路径遍历 ../）、限制单文件大小、设置连接超时、添加鉴权中间件，并将上传目录与程序目录隔离。
选择哪种方式，取决于你的约束条件；但无论选哪条路，明确的数据边界 + 严谨的错误处理，永远是网络编程的基石。
