首先实现文件上传功能,通过http.Request.ParseMultipartForm解析表单,调用request.FormFile获取文件句柄,并用io.Copy将文件保存至服务器路径,同时限制文件大小和类型以防止恶意上传。

在Go语言(Golang)开发中,实现文件的上传与下载是Web服务中的常见需求,比如用户头像上传、附件下载等场景。本文将从基础原理到完整示例,带你一步步实现一个简单但实用的文件上传下载服务。
1. 实现文件上传功能
文件上传通常通过HTTP的multipart/form-data格式提交。Golang的net/http包原生支持解析这种请求。
关键步骤:
使用http.Request.ParseMultipartForm()解析表单数据 调用request.FormFile()获取上传的文件句柄 使用io.Copy()将文件内容保存到服务器指定路径 限制文件大小和类型,防止恶意上传
示例代码:
立即学习“go语言免费学习笔记(深入)”;
func uploadHandler(w http.ResponseWriter, r *http.Request) { 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("file") if err != nil { http.Error(w, "获取文件失败", http.StatusBadRequest) return } defer file.Close() // 创建本地文件 dst, err := os.Create("./uploads/" + handler.Filename) if err != nil { http.Error(w, "创建文件失败", http.StatusInternalServerError) return } defer dst.Close() // 拷贝文件内容 _, err = io.Copy(dst, file) if err != nil { http.Error(w, "保存文件失败", http.StatusInternalServerError) return } fmt.Fprintf(w, "文件 %s 上传成功", handler.Filename)}
2. 实现文件下载功能
文件下载的核心是设置正确的响应头,告诉浏览器这是一个需要下载的文件,而不是直接展示。
关键点:
使用os.Open()打开服务器上的文件 设置Content-Disposition头触发下载 设置Content-Type为application/octet-stream表示二进制流 使用http.ServeFile()或io.Copy()发送文件内容
示例代码:
立即学习“go语言免费学习笔记(深入)”;
func downloadHandler(w http.ResponseWriter, r *http.Request) { filename := r.URL.Query().Get("name") if filename == "" { http.Error(w, "缺少文件名", http.StatusBadRequest) return } filepath := "./uploads/" + filename // 检查文件是否存在 if _, err := os.Stat(filepath); os.IsNotExist(err) { http.Error(w, "文件不存在", http.StatusNotFound) return } // 设置响应头 w.Header().Set("Content-Disposition", "attachment; filename="+filename) w.Header().Set("Content-Type", "application/octet-stream") // 发送文件 http.ServeFile(w, r, filepath)}
3. 安全与优化建议
在生产环境中,必须考虑安全性和稳定性。
文件名安全:避免路径穿越攻击,如../../etc/passwd。可使用path.Base()提取文件名 文件类型校验:检查文件扩展名或读取前几个字节(magic number)判断真实类型 大小限制:在ParseMultipartForm中设置合理上限 防重命名冲突:可用UUID或时间戳重命名上传文件 并发访问控制:确保多个用户同时上传不会冲突
4. 完整项目结构示例
一个简单的项目目录结构:
/fileserver├── main.go├── uploads/├── static/│ └── upload.html└── go.mod
main.go 路由注册:
func main() { mux := http.NewServeMux() mux.HandleFunc("/upload", uploadHandler) mux.HandleFunc("/download", downloadHandler) mux.Handle("/", http.FileServer(http.Dir("./static/"))) fmt.Println("服务启动在 :8080") log.Fatal(http.ListenAndServe(":8080", mux))}
配合一个简单的HTML页面即可测试上传功能。
基本上就这些。掌握以上内容后,你可以在此基础上扩展出支持分片上传、断点续传、权限验证等功能。核心在于理解HTTP文件传输机制和Go的标准库能力。
以上就是如何在Golang中开发文件上传下载功能_Golang文件上传下载项目实战汇总的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1420711.html
微信扫一扫
支付宝扫一扫