如何使用Golang开发基础文件下载功能_Golang HTTP文件响应与缓存实现_技术教程

http.ServeFile是最简静态文件下载方案，但需手动设Content-Disposition强制下载、用filepath.Clean防遍历漏洞；生产环境推荐自定义Handler实现权限校验、Range支持与精准缓存控制。

如何用 `http.ServeFile` 快速提供静态文件下载

直接暴露文件路径给客户端下载，http.ServeFile 是最简方案，但仅适用于固定路径、无需权限控制的场景。它会自动设置 Content-Type 和 Last-Modified，但不会设置 Content-Disposition，浏览器可能选择内嵌而非下载。

必须确保传入的 filepath 是绝对路径，相对路径易导致 404 或目录遍历漏洞

若希望强制下载，需手动写响应头：

w.Header().Set("Content-Disposition", "attachment; filename=\"myfile.zip\"")

http.ServeFile 不校验文件是否存在，不存在时返回 404；但若路径含 .. 且未清理，可能被用于读取任意文件（如 /etc/passwd）
不建议在生产环境直接使用，尤其当文件名来自 URL 参数时——必须用 filepath.Clean 并校验前缀

如何手动构造 HTTP 响应实现可控下载

绕过 http.ServeFile 的限制，自己读取文件、写入响应体，能精确控制缓存策略、分块传输、权限校验和断点续传支持。

先用 os.Open 打开文件，再调用 stat, err := f.Stat() 获取大小和修改时间

设置关键响应头：

w.Header().Set("Content-Length", strconv.FormatInt(stat.Size(), 10))
w.Header().Set("Last-Modified", stat.ModTime().UTC().Format(http.TimeFormat))
w.Header().Set("Content-Disposition", "attachment; filename=\""+filename+"\"")

使用 io.Copy 流式写入，避免全量加载大文件到内存：
```
io.Copy(w, f)
```
若需支持 Range 请求（如断点续传），不能直接用 io.Copy，得解析 Range 头、用 f.ReadAt 跳读，并返回 206 Partial Content

如何正确设置缓存头避免重复下载与陈旧内容

缓存行为由客户端决定，服务端只能通过响应头引导。对下载类资源，通常倾向「强缓存 + 校验」组合，而非完全禁用缓存。

静态资源（如版本化包：v1.2.0/app-linux-amd64）适合用 Cache-Control: public, immutable, max-age=31536000
动态生成或内容常变的文件（如用户导出报表），应设 Cache-Control: no-store 或 no-cache，并配合 ETag 校验
若用 ETag，推荐基于文件内容哈希（如 sha256.Sum256）而非修改时间，避免内容未变但时间戳更新导致误判
注意：Expires 已被现代实践弱化，优先用 Cache-Control；两者共存时以 Cache-Control 为准