Gin 能快速搭建网盘后端因其内置路由、中间件、文件上传解析和 JSON 响应能力；纯 net/http 需多写 300 行代码且易漏边界处理；上传需应对大文件、重复文件名、恶意扩展名三类问题。
为什么不用 Gin 就很难快速搭出可用网盘后端
因为 Gin 提供了开箱即用的路由、中间件、文件上传解析和 JSON 响应能力，省掉大量胶水代码。纯 net/http 写一个支持多用户上传、带鉴权、能返回直链的接口，至少要多写 300 行且容易漏掉边界处理（比如 Content-Length 超限没拦截、multipart/form-data 解析失败静默丢弃）。Gin 的 c.FormFile() 和 c.SaveUploadedFile() 直接封装了这些细节。
上传接口必须处理的三个真实问题
实际部署时，用户上传大文件、重复文件名、恶意扩展名这三类情况会立刻暴露逻辑漏洞：
-
大文件阻断：在
gin.Default()前加gin.SetMode(gin.ReleaseMode)，并在路由注册前用router.MaxMultipartMemory = 32 限制单次上传不超过 32MB，否则内存爆掉进程直接 OOM -
文件名冲突：不要直接用
header.Filename存盘，应生成唯一前缀，例如fmt.Sprintf("%s_%d%s", uuid.NewString(), time.Now().Unix(), ext) -
扩展名白名单：从
header.Header.Get("Content-Type")和文件头魔数双重校验，只允许.jpg、.png、.pdf、.zip等明确业务需要的类型，拒绝.php、.exe、.sh
直链生成与防盗链的关键控制点
网盘的核心不是存文件，而是可控地发链接。Gin 里最容易被忽略的是：http.ServeFile 不带任何权限检查，而 http.ServeContent 才能配合 etag 和 Last-Modified 做基础缓存；但真正防盗链得靠中间件拦截 Referer 或签名校验：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 静态文件服务必须走 Gin 路由，不能直接暴露
/uploads/目录给 Nginx —— 否则绕过所有鉴权 - 推荐用时间戳+哈希签名方式生成临时直链，例如
/dl/<file_id>?t=1723362540&s=abc123</file_id>，服务端验证t未超时且s=hmac.Sum256([]byte(file_id + t + secret)).String() - 若用 Nginx 做前置，需配置
secure_link模块并让 Gin 生成对应签名，而不是依赖 Referer（太容易伪造）
本地开发时最常踩的路径坑
Gin 默认工作目录是执行 go run 的位置，但 c.SaveUploadedFile() 的目标路径是相对路径，容易误写成 "./uploads/" + filename 导致文件存到 GOPATH 下而非项目根目录：
立即学习“go语言免费学习笔记（深入）”；
- 统一用
filepath.Join(".", "uploads", newFilename)，并提前os.MkdirAll(filepath.Join(".", "uploads"), 0755) - 读取配置文件（如
config.yaml）时，别硬编码路径，用os.Executable()获取二进制所在目录再拼接，避免打包成可执行文件后找不到配置 - 调试时用
log.Printf("save path: %s", fullPath)打印实际路径，比猜更可靠
