Golang文件上传下载功能网络实现-Golang-PHP中文网

Golang文件上传下载功能网络实现

P粉602998670

发布： 2025-09-09 10:02:01

原创

718人浏览过

首先利用net/http包创建HTTP服务，通过POST接口上传文件并保存，再通过GET接口读取文件实现下载。具体为：注册/upload处理POST请求，解析multipart/form-data表单，获取文件流并写入本地；注册/download接口，校验文件名安全性后设置Content-Disposition响应头，调用http.ServeFile发送文件；主函数中配置路由并启动服务。代码简洁且依赖标准库，需注意添加上传限制、类型检查和路径遍历防护等安全措施。

golang文件上传下载功能网络实现

Go语言实现文件上传下载功能，关键在于利用net/http包构建HTTP服务，通过标准的请求响应机制完成数据传输。下面直接说明如何实现一个简单可靠的文件上传下载服务。

文件上传功能实现

文件上传通常使用HTTP的POST方法，前端通过multipart/form-data格式提交文件。Go服务端需解析该请求，提取文件内容并保存到指定路径。

核心步骤包括：

注册一个POST接口（如/upload）用于接收文件
使用r.ParseMultipartForm()解析请求体
调用r.FormFile()获取上传的文件句柄
创建本地文件并使用io.Copy()将上传内容写入磁盘

示例代码片段：

立即学习“go语言免费学习笔记（深入）”；

<font color="#0000ff">func</font> uploadHandler(w http.ResponseWriter, r *http.Request) {
    <font color="#0000ff">if</font> r.Method != <font color="#a31515">"POST"</font> {
        http.Error(w, <font color="#a31515">"仅支持POST请求"</font>, http.StatusMethodNotAllowed)
        <font color="#0000ff">return</font>
    }

    file, header, err := r.FormFile(<font color="#a31515">"file"</font>)
    <font color="#0000ff">if</font> err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        <font color="#0000ff">return</font>
    }
    <font color="#0000ff">defer</font> file.Close()

    outFile, err := os.Create(header.Filename)
    <font color="#0000ff">if</font> err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        <font color="#0000ff">return</font>
    }
    <font color="#0000ff">defer</font> outFile.Close()

    _, err = io.Copy(outFile, file)
    <font color="#0000ff">if</font> err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        <font color="#0000ff">return</font>
    }

    w.Write([]byte(<font color="#a31515">"文件上传成功"</font>))
}

登录后复制

文件下载功能实现

文件下载通过GET请求触发，服务端读取本地文件并设置合适的响应头，让浏览器自动下载。

MCP官网

Model Context Protocol（模型上下文协议）

查看详情

关键点：

注册GET接口（如/download/:filename）
从请求路径或查询参数中获取文件名
检查文件是否存在，防止路径穿越攻击
设置Content-Disposition为attachment，指定下载文件名
使用http.ServeFile()直接输出文件内容

示例代码：

<font color="#0000ff">func</font> downloadHandler(w http.ResponseWriter, r *http.Request) {
    filename := r.URL.Query().Get(<font color="#a31515">"file"</font>)
    <font color="#0000ff">if</font> filename == <font color="#a31515">""</font> {
        http.Error(w, <font color="#a31515">"缺少文件名"</font>, http.StatusBadRequest)
        <font color="#0000ff">return</font>
    }

    <font color="#008000">// 简单路径安全检查</font>
    <font color="#0000ff">if</font> strings.Contains(filename, <font color="#a31515">"/"</font>) || strings.Contains(filename, <font color="#a31515">"\"</font>) {
        http.Error(w, <font color="#a31515">"非法文件名"</font>, http.StatusBadRequest)
        <font color="#0000ff">return</font>
    }

    filepath := <font color="#a31515">"./uploads/"</font> + filename
    <font color="#0000ff">if</font> _, err := os.Stat(filepath); os.IsNotExist(err) {
        http.Error(w, <font color="#a31515">"文件不存在"</font>, http.StatusNotFound)
        <font color="#0000ff">return</font>
    }

    w.Header().Set(<font color="#a31515">"Content-Disposition"</font>, <font color="#a31515">"attachment; filename="</font>+filename)
    w.Header().Set(<font color="#a31515">"Content-Type"</font>, <font color="#a31515">"application/octet-stream"</font>)

    http.ServeFile(w, r, filepath)
}

登录后复制

服务启动与路由配置

使用http包注册处理函数，并启动HTTP服务器。

<font color="#0000ff">func</font> main() {
    http.HandleFunc(<font color="#a31515">"/upload"</font>, uploadHandler)
    http.HandleFunc(<font color="#a31515">"/download"</font>, downloadHandler)

    <font color="#008000">// 创建上传目录</font>
    os.MkdirAll(<font color="#a31515">"uploads"</font>, 0755)

    <strong>fmt.Println("服务器启动，端口 :8080")</strong>
    http.ListenAndServe(<font color="#a31515">":8080"</font>, nil)
}

登录后复制

前端可通过表单或Ajax上传文件，下载时构造对应URL即可。

基本上就这些。核心逻辑清晰，Go的标准库已足够支撑基础的文件传输需求，无需引入额外框架。注意做好错误处理和安全校验，比如限制上传大小、检查文件类型、防止路径遍历等。

以上就是Golang文件上传下载功能网络实现的详细内容，更多请关注php中文网其它相关文章！