Golang中Gin框架本地文件的断点下载配置-Golang-PHP中文网

Gin 接口需手动实现 Range 请求支持，因 c.File() 不处理 Range 头而返回完整文件；应解析 Range、校验范围、设 206 状态及 Content-Range 头，并用 http.ServeContent() 流式分段响应。

golang中gin框架本地文件的断点下载配置

Gin 默认的 c.File() 不处理 Range 请求头，直接返回 200 和完整文件，客户端无法续传。必须手动解析 Range、计算偏移、设置响应头并分段返回。

先用 c.Request.Header.Get("Range") 检查是否带 Range 头，格式如 "bytes=1024-" 或 "bytes=1024-2047"
调用 os.Stat() 获取文件总大小，再解析出 start 和可选的 end；若 end 为空，按 end = fileSize - 1 计算
务必校验范围合法性：start >= 0 && start ，否则返回 <code>http.StatusRequestedRangeNotSatisfiable (416)
设置响应状态码为 http.StatusPartialContent (206)，并写入 Content-Range: bytes start-end/fileSize 和 Content-Length: end - start + 1
用 http.ServeContent()（而非 c.File()）驱动流式分段输出，它会自动处理 If-Range、ETag 和边界读取

c.File() 内部调用的是 http.ServeFile()，它忽略所有 Range 相关逻辑，强制返回 200 和完整文件体。即使客户端发了 Range: bytes=1024-，服务端也视而不见，导致已下载部分被重复写入、文件损坏。

现象：curl -H "Range: bytes=1024-" http://localhost/download 仍返回全部内容，且响应头无 Content-Range
本质：Gin 的 c.File() 是静态文件快捷封装，不介入 HTTP 范围请求协商流程
替代方案只有两个：自己手写 http.ServeContent() 逻辑，或改用 c.DataFromReader() 配合自定义 io.ReadSeeker

http.ServeContent() 是 Go 标准库中唯一原生支持 Range 的机制，它要求你提供一个 io.ReadSeeker 和准确的 modtime，由它内部完成切片、头设置和流控。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

打开文件时必须用 os.Open()（非 os.Create()），确保支持 Seek()
获取 modtime 用 stat.ModTime()，不能硬编码或忽略，否则 If-Range 校验失败会退化为全量响应
调用时传入 http.ServeContent(c.Writer, c.Request, filename, modtime, file)，其中 file 是 *os.File（满足 io.ReadSeeker）
注意：如果文件路径含中文或特殊字符，需提前用 url.PathEscape() 编码 filename，否则 Content-Disposition 可能解析失败

即便代码逻辑正确，生产环境仍常因中间件或部署层破坏 Range 行为。

反向代理（如 Nginx）默认不透传 Range 头，需显式配置 proxy_set_header Range $http_range; 和 proxy_pass_request_headers on;
某些 CDN（如 Cloudflare）会主动 strip Range 并缓存全量响应，导致始终返回 200 —— 必须在控制台关闭「Range Request」优化选项
Windows 下文件系统（FAT32）对 >4GB 文件的 Seek() 可能失败，报 syscall.EINVAL，建议优先用 http.ServeContent() 而非手动 Seek+Write
浏览器开发者工具 Network 面板有时隐藏 206 响应，实际抓包（如 Wireshark 或 curl -v）才能确认是否真走断点逻辑

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！