基于Go語言實現(xiàn)文件上傳服務(wù)的示例代碼
更新時間：2025年08月11日 08:25:47 作者：程序員愛釣魚
在 Web 開發(fā)中,文件上傳 是常見需求,例如頭像上傳、文檔存儲、圖片分享等功能,Go 語言的標(biāo)準(zhǔn)庫 net/http 已經(jīng)內(nèi)置了對 multipart/form-data 類型的支持,能讓我們輕松構(gòu)建一個文件上傳服務(wù),本文將帶你實現(xiàn)一個可運行的文件上傳接口,需要的朋友可以參考下
引言
在 Web 開發(fā)中，文件上傳 是常見需求，例如頭像上傳、文檔存儲、圖片分享等功能。Go 語言的標(biāo)準(zhǔn)庫 net/http 已經(jīng)內(nèi)置了對 multipart/form-data 類型的支持，能讓我們輕松構(gòu)建一個文件上傳服務(wù)。
本文將帶你實現(xiàn)一個可運行的文件上傳接口，并附帶 HTML 表單和 curl 測試方法。
一、目標(biāo)功能
路徑：/upload
方法：POST
表單字段：
file：上傳文件desc：文件描述（可選）
保存文件到本地 ./uploads 目錄
返回 JSON 結(jié)果
二、核心知識點
r.ParseMultipartForm(maxMemory)：解析multipart/form-data表單r.FormFile("file")：獲取上傳的文件io.Copy(dst, src)：保存文件到本地- 表單字段獲?。?code>r.FormValue("desc")
- 文件權(quán)限控制：
os.Create()/os.MkdirAll()
三、完整代碼
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
"os"
"path/filepath"
)
type UploadResponse struct {
Filename string `json:"filename"`
Size int64 `json:"size"`
Desc string `json:"desc"`
Status string `json:"status"`
}
func uploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
return
}
// 解析上傳表單（maxMemory 5MB，超過部分存臨時文件）
err := r.ParseMultipartForm(5 << 20)
if err != nil {
http.Error(w, "Error parsing form: "+err.Error(), http.StatusBadRequest)
return
}
// 獲取表單字段
desc := r.FormValue("desc")
// 獲取文件
file, handler, err := r.FormFile("file")
if err != nil {
http.Error(w, "Error retrieving file: "+err.Error(), http.StatusBadRequest)
return
}
defer file.Close()
// 確保保存目錄存在
os.MkdirAll("./uploads", os.ModePerm)
// 保存文件
filePath := filepath.Join("uploads", handler.Filename)
dst, err := os.Create(filePath)
if err != nil {
http.Error(w, "Error saving file: "+err.Error(), http.StatusInternalServerError)
return
}
defer dst.Close()
size, err := io.Copy(dst, file)
if err != nil {
http.Error(w, "Error writing file: "+err.Error(), http.StatusInternalServerError)
return
}
// 返回 JSON 響應(yīng)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(UploadResponse{
Filename: handler.Filename,
Size: size,
Desc: desc,
Status: "success",
})
}
func main() {
http.HandleFunc("/upload", uploadHandler)
fmt.Println("文件上傳服務(wù)已啟動：http://localhost:8080/upload")
http.ListenAndServe(":8080", nil)
}
四、測試方法
1. HTML 表單測試
保存為 upload.html：
<!DOCTYPE html> <html> <body> <h2>文件上傳測試</h2> <form action="http://localhost:8080/upload" method="post" enctype="multipart/form-data"> 文件描述: <input type="text" name="desc"> 選擇文件: <input type="file" name="file"> <input type="submit" value="上傳"> </form> </body> </html>
打開瀏覽器選擇文件并提交。
2. curl 命令測試
curl -X POST http://localhost:8080/upload \
-F "desc=測試圖片" \
-F "file=@test.png"
五、運行效果
成功上傳后返回：
{
"filename": "test.png",
"size": 15324,
"desc": "測試圖片",
"status": "success"
}
文件會保存在 ./uploads/test.png。
六、注意事項
上傳限制： 通過 r.ParseMultipartForm(maxMemory) 控制內(nèi)存占用，超過部分會寫入臨時文件。
安全性：
- 校驗文件類型（避免執(zhí)行惡意文件）
- 生成唯一文件名（避免覆蓋）
- 設(shè)置合理的文件大小限制（可用
http.MaxBytesReader）
跨域請求： 如果前端與后端不在同一域名，需要設(shè)置 Access-Control-Allow-Origin 等 CORS 頭。
七、進階擴展
- 上傳時自動生成文件唯一 ID（防止文件名沖突）
- 返回文件訪問 URL
- 將文件上傳到云存儲（如 AWS S3、阿里云 OSS）
- 支持多文件同時上傳（
r.MultipartForm.File["file"]）
到此這篇關(guān)于基于Go語言實現(xiàn)文件上傳服務(wù)的示例代碼的文章就介紹到這了,更多相關(guān)Go文件上傳服務(wù)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了go install/build生成的文件命名和路徑操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-12-12
更換GORM默認SQLite驅(qū)動出現(xiàn)的問題解決分析
這篇文章主要為大家介紹了更換GORM默認SQLite驅(qū)動出現(xiàn)的問題解決分析,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2024-01-01
k8s容器互聯(lián)flannel?vxlan通信原理
這篇文章主要為大家介紹了k8s容器互聯(lián)flannel?vxlan通信原理詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-04-04
本文主要介紹了Go之集合slice的實現(xiàn)，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-08-08
本文詳細解析了Go語言中g(shù)conv.Map()方法的實現(xiàn)原理,該方法通過遞歸處理將各種數(shù)據(jù)類型轉(zhuǎn)換為map[string]any格式,感興趣的可以了解一下2026-05-05
YAML是YAML?Ain't?a?Markup?Language的縮寫,YAML不是一種標(biāo)記語言,相比JSON格式的方便,這篇文章主要給大家介紹了關(guān)于Golang實踐筆錄之讀取yaml配置文件的相關(guān)資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2024-01-01
這篇文章主要為大家詳細介紹了如何使用golang實現(xiàn)PDF圖片提取功能,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2025-11-11
Go語言中uintptr和unsafe.Pointer的區(qū)別的實現(xiàn)小結(jié)
Go語言中的uintptr和unsafe.Pointer都是用于底層內(nèi)存操作的類型,本文就來介紹一下uintptr和unsafe.Pointer的區(qū)別,具有一定的參考價值,感興趣的可以了解一下2025-10-10
golang gorm 計算字段和獲取sum()值的實現(xiàn)
這篇文章主要介紹了golang gorm 計算字段和獲取sum()值的實現(xiàn)操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-12-12
這篇文章主要介紹了GO語言類型轉(zhuǎn)換和類型斷言,以實例形式詳細分析了類型轉(zhuǎn)換和類型斷言的概念與使用技巧,需要的朋友可以參考下2015-01-01