Golang Web应用中文件上传与访问的完整指南

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    // 检查请求方法是否为POST
    if r.Method != http.MethodPost {
        http.Error(w, "Only POST requests are allowed", http.StatusMethodNotAllowed)
        return
    }

    // 解析multipart/form-data请求
    // 参数为最大内存限制，超过此限制的文件部分将写入临时文件
    // 10 << 20 表示 10MB
    const maxMemory = 10 << 20 // 10 MB
    err := r.ParseMultipartForm(maxMemory)
    if err != nil {
        http.Error(w, "Failed to parse multipart form: "+err.Error(), http.StatusInternalServerError)
        return
    }

    // 确保在函数结束时清理临时文件
    // r.MultipartForm 会在 ParseMultipartForm 调用后被填充
    defer r.MultipartForm.RemoveAll()

    // 此时，r.MultipartForm 包含了所有解析后的表单数据和文件数据
    fmt.Printf("成功解析请求，表单数据和文件已准备就绪。\n")
}

package main

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

// ensureDirExists 辅助函数，确保目录存在
func ensureDirExists(dirName string) error {
    _, err := os.Stat(dirName)
    if os.IsNotExist(err) {
        return os.MkdirAll(dirName, 0755) // 0755权限：所有者读写执行，组用户和其他用户读执行
    }
    return err
}

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Println("接收到文件上传请求...")

    if r.Method != http.MethodPost {
        http.Error(w, "仅支持POST请求进行文件上传", http.StatusMethodNotAllowed)
        return
    }

    // 确保上传目录存在
    uploadDir := "./uploaded" // 文件将保存到当前目录下的 'uploaded' 文件夹
    if err := ensureDirExists(uploadDir); err != nil {
        http.Error(w, "无法创建上传目录: "+err.Error(), http.StatusInternalServerError)
        fmt.Println("错误: 无法创建上传目录:", err)
        return
    }

    // 解析multipart/form-data请求，限制内存使用为24KB，超出部分写入临时文件
    // 24KB 是一个相对较小的示例值，实际应用中应根据需求调整
    const maxMemory = (1 << 10) * 24 // 24KB
    err := r.ParseMultipartForm(maxMemory)
    if err != nil {
        http.Error(w, "解析表单失败: "+err.Error(), http.StatusInternalServerError)
        fmt.Println("错误: 解析表单失败:", err)
        return
    }

    // 确保在函数结束时清理所有临时文件
    defer r.MultipartForm.RemoveAll()

    // 检查是否有文件上传
    if len(r.MultipartForm.File) == 0 {
        fmt.Println("没有检测到上传文件。")
        http.Error(w, "没有检测到上传文件。", http.StatusBadRequest)
        return
    }

    // 遍历所有上传的文件
    for formFieldName, fileHeaders := range r.MultipartForm.File {
        for _, fileHeader := range fileHeaders {
            fmt.Printf("开始处理文件: %s (表单字段: %s)\n", fileHeader.Filename, formFieldName)

            // 打开上传文件
            infile, err := fileHeader.Open()
            if err != nil {
                http.Error(w, "无法打开上传文件: "+err.Error(), http.StatusInternalServerError)
                fmt.Println("错误: 无法打开上传文件:", err)
                return
            }
            defer infile.Close() // 确保在函数退出时关闭上传文件的读取流

            // 创建目标文件路径
            // 注意：这里直接使用fileHeader.Filename，实际应用中应进行文件名清理和唯一化
            // 以防止路径遍历攻击和文件名冲突。例如：
            // safeFilename := sanitizeFilename(fileHeader.Filename)
            // uniqueFilename := generateUniqueName(safeFilename)
            // outputPath := filepath.Join(uploadDir, uniqueFilename)
            outputPath := filepath.Join(uploadDir, fileHeader.Filename)

            outfile, err := os.Create(outputPath)
            if err != nil {
                http.Error(w, "无法创建目标文件: "+err.Error(), http.StatusInternalServerError)
                fmt.Println("错误: 无法创建目标文件:", err)
                return
            }
            defer outfile.Close() // 确保在函数退出时关闭目标文件的写入流

            // 将上传文件内容复制到目标文件
            written, err := io.Copy(outfile, infile)
            if err != nil {
                http.Error(w, "写入文件失败: "+err.Error(), http.StatusInternalServerError)
                fmt.Println("错误: 写入文件失败:", err)
                return
            }

            fmt.Fprintf(w, "文件 '%s' (字段: %s) 上传成功，大小: %s 字节\n", fileHeader.Filename, formFieldName, strconv.FormatInt(written, 10))
        }
    }

    fmt.Println("所有文件处理完毕。")
}

func main() {
    http.HandleFunc("/upload", uploadHandler)
    fmt.Println("Golang文件上传服务器启动在 :8080，请访问 /upload 进行文件上传测试。")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Println("服务器启动失败:", err)
    }
}

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>文件上传测试</title>
    <style>
        body { font-family: Arial, sans-serif; margin: 20px; }
        form { border: 1px solid #ccc; padding: 20px; border-radius: 5px; max-width: 400px; margin: 0 auto; }
        input[type="file"] { margin-bottom: 15px; display: block; }
        input[type="submit"] { background-color: #4CAF50; color: white; padding: 10px 15px; border: none; border-radius: 4px; cursor: pointer; }
        input[type="submit"]:hover { background-color: #45a049; }
        h1 { text-align: center; color: #333; }
    </style>
</head>
<body>
    <h1>上传文件到Golang服务器</h1>
    <form action="/upload" method="post" enctype="multipart/form-data">
        <label for="myFile">选择文件 (可多选):</label>
        <input type="file" id="myFile" name="myFile" multiple><br>
        <input type="submit" value="上传文件">
    </form>
</body>
</html>