使用Go的archive/zip和net/http实现Web文件压缩解压:接收ZIP上传并解压至指定目录,支持multipart表单解析与流式读取。

在Golang开发Web应用时,经常需要处理用户上传的文件压缩包或提供打包下载功能。实现文件的压缩与解压不仅能节省带宽,还能提升用户体验。Go语言标准库中的 archive/zip 包提供了完整的ZIP文件操作支持,结合 net/http 可轻松实现Web端的压缩与解压功能。
当用户上传一个ZIP文件时,服务端可以即时解压并读取内容。以下是一个通过HTTP接口接收ZIP文件并解压到指定目录的示例:
func unzipHandler(w http.ResponseWriter, r *http.Request) {
// 只允许POST方法
if r.Method != "POST" {
http.Error(w, "仅支持POST请求", http.StatusMethodNotAllowed)
return
}
// 解析multipart表单,限制内存使用(例如32MB)
err := r.ParseMultipartForm(32 << 20)
if err != nil {
http.Error(w, "解析表单失败", http.StatusBadRequest)
return
}
file, handler, err := r.FormFile("zipfile")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
// 创建临时文件保存上传的ZIP
tempFile, err := os.CreateTemp("", "*.zip")
if err != nil {
http.Error(w, "创建临时文件失败", http.StatusInternalServerError)
return
}
defer os.Remove(tempFile.Name()) // 处理完成后删除
defer tempFile.Close()
// 将上传内容写入临时文件
_, err = io.Copy(tempFile, file)
if err != nil {
http.Error(w, "保存文件失败", http.StatusInternalServerError)
return
}
// 打开ZIP文件进行解压
zipReader, err := zip.OpenReader(tempFile.Name())
if err != nil {
http.Error(w, "打开ZIP失败", http.StatusBadRequest)
return
}
defer zipReader.Close()
targetDir := "./uploads/" // 解压目标目录
for _, f := range zipReader.File {
filePath := filepath.Join(targetDir, f.Name)
// 防止路径遍历攻击
if !strings.HasPrefix(filePath, filepath.Clean(targetDir)+string(os.PathSeparator)) {
http.Error(w, "非法文件路径", http.StatusBadRequest)
return
}
if f.FileInfo().IsDir() {
os.MkdirAll(filePath, os.ModePerm)
continue
}
// 确保父目录存在
os.MkdirAll(filepath.Dir(filePath), os.ModePerm)
out, err := os.OpenFile(filePath, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, f.Mode())
if err != nil {
http.Error(w, "创建文件失败: "+filePath, http.StatusInternalServerError)
return
}
rc, err := f.Open()
if err != nil {
out.Close()
http.Error(w, "读取ZIP内文件失败", http.StatusInternalServerError)
return
}
_, err = io.Copy(out, rc)
rc.Close()
out.Close()
if err != nil {
http.Error(w, "写入文件失败", http.StatusInternalServerError)
return
}
}
w.Write([]byte("解压成功"))
}
有时需要将多个文件(如日志、图片等)打包成ZIP供用户下载。可以通过 zip.Writer 将文件写入HTTP响应流中,无需生成本地临时文件。
func downloadZipHandler(w http.ResponseWriter, r *http.Request) {
// 设置响应头,触发浏览器下载
w.Header().Set("Content-Type", "application/zip")
w.Header().Set("Content-Disposition", `attachment; filename="files.zip"`)
zipWriter := zip.NewWriter(w)
defer zipWriter.Close()
filesToZip := []string{"./data/file1.txt", "./data/image.png"}
for _, filePath := range filesToZip {
fileInfo, err := os.Stat(filePath)
if err != nil || fileInfo.IsDir() {
continue
}
file, err := os.Open(filePath)
if err != nil {
continue
}
defer file.Close()
// 在ZIP中创建新文件
fw, err := zipWriter.Create(filepath.Base(filePath))
if err != nil {
file.Close()
continue
}
_, err = io.Copy(fw, file)
file.Close()
if err != nil {
return // 写入失败直接中断
}
}
// 注意:不要手动调用w.Write()或其他写操作,以免破坏ZIP结构
}
在生产环境中使用压缩功能需注意以下几点:
立即学习“go语言免费学习笔记(深入)”;
不实际解压的情况下查看ZIP内文件列表,可用于前端展示压缩包结构:
func listZipHandler(w http.ResponseWriter, r *http.Request) {
path := r.URL.Query().Get("file")
if path == "" {
http.Error(w, "缺少文件参数", http.StatusBadRequest)
return
}
reader, err := zip.OpenReader(path)
if err != nil {
http.Error(w, "无法读取ZIP文件", http.StatusBadRequest)
return
}
defer reader.Close()
var files []string
for _, f := range reader.File {
files = append(files, f.Name)
}
json.NewEncoder(w).Encode(map[string]interface{}{
"files": files,
"total": len(files),
})
}
基本上就这些。使用Golang的标准库就能高效实现Web场景下的文件压缩与解压,代码简洁且运行稳定,适合集成进各类文件服务系统中。关键是处理好边界情况和安全性问题,才能保证功能可靠可用。
以上就是如何使用Golang开发Web文件压缩与解压功能_Golang Web文件压缩处理实践的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号