gin.StaticFS不支持HTTP Range请求，导致音视频分片加载失败而卡顿或406错误；需改用支持断点续传的处理器（如http.FileServer），并严格校验路径防遍历、正确设置Content-Type/Content-Length、启用sendfile优化I/O。
为什么用 gin.StaticFS 直接服务音视频文件会卡顿或 406 错误
因为浏览器请求音视频时默认带 Range 头（分片加载），而 gin.StaticFS 不支持 HTTP Range 请求，导致播放器反复重试、卡在 loading 或返回 406 Not Acceptable（实际是服务端没返回 206 Partial Content）。
- 必须替换为支持断点续传的静态文件处理器，比如自定义
http.ServeFile+ 手动处理Range，或更稳妥地用http.FileServer配合http.StripPrefix和自定义http.ResponseWriter - 别把音视频文件放在
./static下靠router.Static("/static", "./static")暴露——它底层调的是http.ServeFile，但 Gin 封装后屏蔽了 Range 支持 - 路径映射要避开 Gin 的路由冲突：比如音视频资源统一走
/media/前缀，且该前缀不能被其他GET路由捕获
如何安全地从 URL 路径读取本地音视频文件（防路径遍历）
用户请求 /media/movie.mp4，你不能直接拼接 "/var/www/media/" + filepath.Clean(r.URL.Path)——filepath.Clean 对 ../etc/passwd 仍可能绕过，尤其 Windows 下大小写和反斜杠行为不一致。
- 用
filepath.Join拼接根目录与清理后的子路径，再用strings.HasPrefix校验最终绝对路径是否仍在白名单目录内 - 示例校验逻辑：
root := "/data/media" path := filepath.Join(root, filepath.Clean(strings.TrimPrefix(r.URL.Path, "/media/"))) if !strings.HasPrefix(path, root) { http.Error(w, "Forbidden", http.StatusForbidden) return } - 拒绝任何包含
.htaccess、.env、..（出现在路径中间）或空字节的请求路径，Gin 中可在中间件里用正则预筛
Gin 中怎么让前端能正确获取音视频元信息（时长、尺寸、格式）
浏览器 <video> 标签需要 Content-Type 和 Content-Length 才能计算进度条、显示时长；缺失或错误会导致“未知时长”或无法拖拽。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 别用
ctx.Data硬塞二进制——它不自动推导 MIME 类型；改用ctx.Header("Content-Type", mime.TypeByExtension(ext))+ctx.Data(status, contentType, data) - 对大文件，优先用
http.ServeFile（它会自动设Content-Length和Content-Type），而不是读全文件到内存再Data - 扩展名映射要完整：MP4 用
video/mp4，WebM 用video/webm，AAC 用audio/aac；Golang 标准库mime.TypeByExtension支持有限，建议自己维护一个map[string]string补充常见音视频类型
并发播放多路高清视频时 CPU 占用飙升怎么办
不是 Gin 本身的问题，而是每个请求都触发一次 os.Open + io.Copy，当几十个 1080p 视频同时读取，磁盘 I/O 和系统调用开销会拉满 CPU，尤其在机械硬盘或未启用 sendfile 的环境。
立即学习“go语言免费学习笔记（深入）”；
- 启用
http.ServeFile的底层优化：Linux 下确保内核支持sendfile（默认开启），它能让内核直接 DMA 传输文件，绕过 Go runtime 内存拷贝 - 加一层简单文件句柄缓存：对频繁访问的热门视频，用
sync.Map缓存已打开的*os.File，避免重复Open；注意设置最大缓存数并定期 close 闲置句柄 - 别在 handler 里做转码或截图——那些操作必须剥离到独立服务（如 FFmpeg CLI + job queue），Gin 只负责调度和分发原始文件
真正难的不是跑起来，是让用户拖动进度条时不卡、连播十个小时不丢帧、同一文件被一百人同时点开还能稳住——这些都卡在文件系统层和 HTTP 协议细节里，不是加个 gin.Default() 就能解决的。
