gin 不处理视频解析，仅负责 http 请求分发；真正解析由自写 go 代码完成（如调用 ffmpeg、解析 mp4/hls、提取关键帧），gin 仅将其封装为 api；需限制上传大小防大文件攻击。
gin 本身不处理视频解析，它只负责 HTTP 请求分发和响应控制。真正在做「轻量视频解析」的，是你自己写的 Go 代码（比如调用 ffmpeg 命令、读取 MP4 头部、解析 HLS .m3u8、提取关键帧元信息等），gin 只是把这部分能力暴露成 API。
如果你现在卡在「怎么让 Gin 接口安全、稳定、低延迟地返回视频解析结果」，下面这些点才是实际要解决的。
如何用 gin 接收并校验视频文件上传
用户上传视频通常走 POST /parse + multipart/form-data，但直接 c.FormFile("file") 拿到文件后立刻解析，容易被恶意大文件拖垮服务。
- 务必限制上传大小：
r.MaxMultipartMemory = 32 ，放在 <code>gin.Default()之后、路由注册之前 - 检查文件头魔数，而非只看后缀名：
buf := make([]byte, 512)+io.ReadFull(file, buf)，再比对buf[0:4] == []byte{0x00, 0x00, 0x00, 0x18}（MP4）或buf[0:3] == []byte("ID3")（MP3） - 不要把整个文件
ReadAll进内存；用io.Copy流式写入临时文件，或直接传给exec.Command("ffprobe", ...)的 stdin
ffprobe 和纯 Go 解析器怎么选
轻量 ≠ 不用外部工具。Go 原生没有完整视频解析库，硬啃 ISO-BMFF 或 Matroska 格式成本远高于调用 ffprobe。
- 用
ffprobe -v quiet -print_format json -show_format -show_streams能在 100ms 内拿到时长、码率、分辨率、编码格式等核心字段，适合接口级快速响应 - 若需离线/无依赖部署，可考虑
github.com/edgeware/mp4ff（仅 MP4）或github.com/wader/goversion（简单头部读取），但它们不支持 H.265/AV1 流、不解析字幕轨道、不处理损坏文件 - 注意
ffprobe调用必须设超时：cmd := exec.Command("ffprobe", ...); cmd.Stdin = file; cmd.Stdout, cmd.Stderr = &out, &err; cmd.Wait() → 改为 cmd.Start() + chan + select { case
为什么 c.Data 直接返回二进制流比 c.JSON 更合适
视频解析结果本质是结构化数据（JSON），但如果你返回的是缩略图、GIF 截帧、或转码后的轻量 MP4 片段，就该用原始字节流，避免 JSON base64 编码膨胀 33% 且客户端还得解码。
- 返回 JPEG 缩略图：
c.Header("Content-Type", "image/jpeg"); c.Header("Content-Disposition", `inline; filename="thumb.jpg"`); c.Data(http.StatusOK, "image/jpeg", jpegBytes) - 返回 HLS 列表：
c.Header("Content-Type", "application/vnd.apple.mpegurl"); c.String(http.StatusOK, string(m3u8Content)) - 千万别用
c.JSON包裹几 MB 的 base64 字符串——HTTP body 会翻倍，gzip 也压不住，移动端极易超时
并发解析请求时最容易崩的三个点
视频解析是 CPU 密集型操作，gin 默认的 goroutine 模型会放任并发请求全部冲向 ffprobe，导致进程假死或 OOM。
- 用带缓冲的 channel 做简单限流：
var parseLimiter = make(chan struct{}, 3)，每个请求先parseLimiter ，完成后 <code> -
ffprobe进程没回收干净？加defer cmd.Process.Kill()和signal.Notify捕获 SIGTERM - 临时文件不清理：用
os.CreateTemp("", "video-*.mp4")创建，解析完立刻os.Remove，别依赖 defer —— defer 在函数 return 后才执行，中间 panic 就漏删了
真正卡住项目的，往往不是“怎么解析”，而是“怎么不让解析拖垮整个服务”。gin 的角色很明确：管好入口、管好出口、管好超时与错误，剩下的交给专注视频的工具链。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
