Go语言上传文件到服务器的实用方法

在开发Web应用或后台服务时，文件上传是一个常见的需求。比如用户上传头像、提交文档，或是日志系统定时发送本地日志到远程服务器。使用Go语言实现文件上传，既高效又简洁，特别适合对性能有要求的网络服务场景。

基础的HTTP文件上传

Go标准库中的 net/http 支持完整的HTTP客户端和服务端功能。要上传一个文件，通常通过构造 multipart/form-data 类型的请求来实现。下面是一个简单的例子，把本地的 avatar.jpg 上传到指定服务器接口。

package main

import (
	"bytes"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func uploadFile(filepath, url string) error {
	file, err := os.Open(filepath)
	if err != nil {
		return err
	}
	defer file.Close()

	var buf bytes.Buffer
	w := multipart.NewWriter(&buf)

	formFile, err := w.CreateFormFile("uploadfile", filepath)
	if err != nil {
		return err
	}

	_, err = io.Copy(formFile, file)
	if err != nil {
		return err
	}

	w.Close()

	req, err := http.NewRequest("POST", url, &buf)
	if err != nil {
		return err
	}
	req.Header.Set("Content-Type", w.FormDataContentType())

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		return err
	}
	defer resp.Body.Close()

	return nil
}

func main() {
	uploadFile("avatar.jpg", "http://example.com/upload")
}

这段代码打开一个文件，用 multipart.Writer 构造表单数据，然后发起POST请求。服务器端只要能解析 multipart 请求，就能接收到这个文件。这种模式适用于大多数中小型项目。

增加进度提示

上传大文件时，用户往往希望看到进度条。虽然Go本身不直接提供上传进度，但可以通过监控写入 buffer 的字节数来模拟。一种做法是封装一个带计数功能的 io.Writer，每次写入时更新已传输量。

例如，在调用 io.Copy 时替换为自定义的 writer，每写入一定数据就打印当前进度。虽然控制台不能显示图形进度条，但在日志系统中输出“已上传 50%”这样的信息，对运维人员很有帮助。

优化网络传输效率

如果上传频率高或文件体积大，可以考虑压缩文件再传输。比如先用 gzip 压缩日志文件，再上传。接收端解压后存储，既能节省带宽，又能加快传输速度。Go内置的 compress/gzip 包很容易集成到上传流程中。

另外，设置合理的超时时间也很关键。默认的HTTP客户端没有超时，一旦网络卡住，程序可能一直挂起。建议设置连接和读写超时：

client := &http.Client{
	Timeout: 30 * time.Second,
}

这样即使网络不稳定，也能及时失败并重试，避免资源堆积。

并发上传多个文件

如果有多个文件需要上传，比如同步整个目录，可以用 goroutine 并发处理。每个文件开一个协程上传，整体速度明显提升。注意控制并发数量，避免打开太多连接导致服务器拒绝或本地资源耗尽。

sem := make(chan struct{}, 5) // 最多5个并发
for _, file := range files {
	sem <- struct{}{}
	go func(f string) {
		uploadFile(f, serverURL)
		<-sem
	}(file)
}

这种方式在批量上传监控截图或传感器数据时非常实用。

Go语言的简洁性和高性能让文件上传变得可控又可靠。无论是做内部工具还是公开服务，掌握这些基本技巧都能让网络传输更顺畅。