r.Static()裸挂载存在路径穿越风险，必须改用r.StaticFS配合os.DirFS（Go 1.16+）或手动校验filepath.Clean()；需注册自定义MIME类型、设置Content-Disposition支持中文名与PDF/MP4正确解析；上传目录须用绝对路径并预检存在性；NoRoute必须置于StaticFS之后以防覆盖文件路由。
直接用 r.Static() 挂载上传目录就能跑起来，但真要当网盘用，必须解决文件路径越界、MIME类型错误、中文文件名乱码、未授权访问这四个实际问题。
Static() 挂载目录时如何防止路径穿越？
Gin 的 r.Static() 默认不做路径净化，攻击者构造 GET /files/../../etc/passwd 可能读取服务器任意文件。这不是理论风险，是真实可复现的漏洞。
- 永远不要用
r.Static("/files", "./uploads")这种裸挂载 —— 它等价于http.FileServer(http.Dir("./uploads"))，无防护 - 改用
r.StaticFS("/files", http.FS(os.DirFS("./uploads")))（Go 1.16+），os.DirFS自动拒绝含..的路径 - 若需兼容旧 Go 版本，手动封装一层：用
http.StripPrefix+ 自定义http.Handler，在 ServeHTTP 中调用filepath.Clean()并校验是否仍以"./uploads"开头
浏览器打不开 PDF/MP4/中文名文件？查 MIME 和 Header
默认 http.FileServer 对未知后缀返回 text/plain，导致 PDF 下载失败、MP4 无法播放、中文文件名显示为乱码或截断。
- 注册自定义 MIME 类型：启动前调用
mime.AddExtensionType(".pdf", "application/pdf")、mime.AddExtensionType(".mp4", "video/mp4") - 中文文件名必须加
Content-Disposition: attachment; filename*=UTF-8''xxx.pdf，Gin 原生StaticFS不自动设这个，得自己写 Handler - 简单方案：对
/files/*路由统一用c.Header("Content-Disposition", ...)+c.DataFromReader(...)手动响应，绕过StaticFS的自动逻辑
上传文件后，StaticFS 为啥不生效？工作目录和 embed.FS 的坑
本地开发时 go run main.go 工作目录是项目根，但打包成二进制后，./uploads 相对路径会失效；用 embed.FS 嵌入静态资源又无法写入上传文件。
- 生产环境必须用绝对路径：启动时用
flag.String("upload-dir", "/var/www/uploads", "upload directory")显式指定，避免依赖工作目录 -
embed.FS只读，不能用于上传目录 —— 它只适合打包前端 HTML/CSS/JS，别和用户上传混用 - 验证路径是否存在：在
r.StaticFS()前加if _, err := os.Stat(uploadDir); os.IsNotExist(err) { log.Fatal(err) }
NoRoute 不能兜底 /files/ 路径，否则上传文件被 index.html 覆盖
SPA 模式常用 r.NoRoute() 返回 index.html，但如果把它放在 r.StaticFS("/files", ...) 之后，所有 /files/xxx 请求都会被兜底拦截，导致真实文件 404。
-
NoRoute必须放在所有StaticFS、GET、POST路由注册之后，且不能覆盖已声明的前缀路径 - 正确顺序：
r.POST("/upload", uploadHandler)→r.StaticFS("/files", ...)→r.GET("/", serveIndex)→r.NoRoute(fallbackToIndex) - 如果需要支持
/files/目录列表，别依赖NoRoute，单独写个r.GET("/files/", listHandler)
真正难的不是挂载静态文件，而是让每个文件都按预期被读取、下载、播放 —— MIME、编码、路径安全、运行时路径这四点漏掉任何一环，网盘就卡在“能跑”和“能用”之间。
