GolangHTTP文件上传接口实现示例-Golang-PHP中文网

GolangHTTP文件上传接口实现示例

P粉602998670

发布： 2025-09-06 10:12:03

原创

564人浏览过

使用Go标准库net/http实现文件上传，通过ParseMultipartForm解析表单，FormFile获取文件句柄，保存到服务器指定目录，同时支持前端HTML表单提交，完整示例包含错误处理与文件路径安全校验。

golanghttp文件上传接口实现示例

实现一个文件上传接口在Go语言中非常直接，利用标准库

net/http

登录后复制

就能快速搭建。下面是一个完整的HTTP文件上传接口示例，包含后端处理和简单的前端表单。

1. 后端：Golang HTTP 文件上传处理

使用

http.Request

登录后复制

的

ParseMultipartForm

登录后复制

方法解析上传的文件，然后通过

request.FormFile

登录后复制

获取文件句柄。

示例代码：

package main

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

// 上传文件处理函数
func uploadHandler(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"
    file, handler, err := r.FormFile("file")
    if err != nil {
        http.Error(w, "获取文件失败", http.StatusBadRequest)
        return
    }
    defer file.Close()

    // 创建保存文件的目录
    uploadDir := "./uploads"
    if err := os.MkdirAll(uploadDir, os.ModePerm); err != nil {
        http.Error(w, "创建目录失败", http.StatusInternalServerError)
        return
    }

    // 构造保存路径，防止路径穿越
    filename := filepath.Base(handler.Filename)
    dstPath := filepath.Join(uploadDir, filename)

    // 创建目标文件
    dst, err := os.Create(dstPath)
    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 (%d bytes)", handler.Filename, handler.Size)
}

func main() {
    // 注册处理函数
    http.HandleFunc("/upload", uploadHandler)

    // 提供静态页面用于测试（可选）
    http.Handle("/", http.FileServer(http.Dir(".")))

    fmt.Println("服务器启动，端口: 8080")
    http.ListenAndServe(":8080", nil)
}

登录后复制

2. 前端：HTML 文件上传表单

在项目根目录下创建一个

index.html

登录后复制

文件，用于测试上传功能。

index.html 内容：

<!DOCTYPE html>
<html>
<head>
    <title>文件上传测试</title>
</head>
<body>
    <h2>上传文件</h2>
    <form action="/upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file" required>
        <button type="submit">上传</button>
    </form>
</body>
</html>

登录后复制