首先创建HTTP服务器并设置上传路由,再通过ParseMultipartForm解析表单,使用formFile获取文件句柄,最后保存文件到服务端。

在Golang中实现文件上传功能并不复杂,主要依赖标准库中的 net/http 和 multipart/form-data 解析能力。下面介绍如何构建一个简单的HTTP服务来接收并保存上传的文件。
1. 创建基本的HTTP服务器
首先启动一个HTTP服务,监听指定端口,并为文件上传设置路由。
package main
import (
"fmt"
"log"
"net/http"
)
func main() {
http.HandleFunc("/upload", uploadHandler)
fmt.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
2. 处理文件上传请求
使用 r.ParseMultipartForm() 解析表单数据,然后通过 formFile 获取上传的文件句柄。
func uploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Only POST allowed", http.StatusMethodNotAllowed)
return
}
// 解析 multipart 表单,最大内存 32MB
err := r.ParseMultipartForm(32
3. 保存上传的文件到本地
将接收到的文件内容写入服务器磁盘。使用 os.Create 创建新文件,并用 io.Copy 写入数据。
import "io"
import "os"
// 创建目标文件
dst, err := os.Create("./uploads/" + handler.Filename)
if err != nil {
http.Error(w, "Unable to create file", http.StatusInternalServerError)
return
}
defer dst.Close()
// 拷贝文件内容
_, err = io.Copy(dst, file)
if err != nil {
http.Error(w, "Failed to save file", http.StatusInternalServerError)
return
}
fmt.Fprintf(w, "File uploaded successfully: %+v\n", handler.Filename)
确保项目根目录下有 ./uploads 文件夹,否则会因路径不存在而报错。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
4. 前端测试表单(可选)
创建一个简单的HTML页面测试上传功能:
访问该页面并提交文件即可触发上传流程。
基本上就这些。Golang的标准库已经提供了足够支持,无需引入第三方框架即可完成基础文件上传功能。注意控制文件大小、校验类型、防止路径遍历等安全问题在生产环境中尤为重要。不过那是下一步要考虑的事。现在先让上传跑起来再说。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










