当前位置：首页 > 文章列表 > Golang > Go教程 > Golang文件上传服务器搭建教程

Golang文件上传服务器搭建教程

2025-12-02 09:28:29 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang文件上传服务器操作指南》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

Go语言通过net/http库支持HTTP文件上传，客户端使用multipart/form-data格式发送文件，服务器端解析请求并保存文件。1. 客户端调用http.NewRequest创建POST请求，利用multipart.NewWriter构建请求体，设置Content-Type头部，并通过io.Copy将文件写入请求体，最后由http.Client发送。2. 服务端通过r.ParseMultipartForm解析表单数据，限制内存大小，再调用r.MultipartForm.File获取文件句柄，读取后保存至本地指定路径，完成上传处理。

Golang如何上传文件到服务器_Golang HTTP文件上传操作实践

在Go语言中实现HTTP文件上传并不复杂，标准库中的 net/http 提供了足够的支持来处理客户端文件上传和服务器端接收。本文将通过一个完整的实践示例，演示如何使用Golang上传文件到服务器。

1. 客户端：发送文件上传请求

要从客户端上传文件，可以使用 http.Post 或更灵活的 http.Client 配合 multipart/form-data 格式发送数据。

以下是一个上传本地文件到指定URL的示例：

package main

import (
    "bytes"
    "fmt"
    "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 body bytes.Buffer
    writer := multipart.NewWriter(&body)

    // 添加文件字段
    part, err := writer.CreateFormFile("uploadfile", filepath)
    if err != nil {
        return err
    }
    _, err = io.Copy(part, file)
    if err != nil {
        return err
    }

    // 关闭writer以写入结尾边界
    writer.Close()

    // 发送POST请求
    req, err := http.NewRequest("POST", url, &body)
    if err != nil {
        return err
    }

    // 设置Content-Type为multipart/form-data
    req.Header.Set("Content-Type", writer.FormDataContentType())

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

    // 输出响应结果
    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println("Response:", string(respBody))

    return nil
}

func main() {
    err := uploadFile("./test.txt", "http://localhost:8080/upload")
    if err != nil {
        fmt.Println("Upload failed:", err)
    }
}

说明：

CreateFormFile 创建名为 uploadfile 的表单字段，并自动设置文件名。
FormDataContentType() 返回正确的Content-Type头，包含boundary信息。
使用 http.NewRequest 可以更灵活地控制请求头和方法。

2. 服务器端：接收并保存上传的文件

服务端需要监听指定路径，解析 multipart 请求，并将文件保存到本地。

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "Only POST allowed", http.StatusMethodNotAllowed)
        return
    }

    // 解析 multipart 表单，限制内存使用（如10MB）
    err := r.ParseMultipartForm(10

关键点：