Go net/http ServeContent 如何为大文件设置正确修改时间

给大文件下载接口设置 http.ServeContent 的修改时间时，应该传入文件自身的 FileInfo.ModTime()，而不是请求到达时间。这样 ServeContent 才能生成可信的 Last-Modified，并正确处理 If-Modified-Since；打开的 *os.File 也能提供它所需的 io.ReadSeeker，不会因为文件很大就先把全部内容读进内存。

最小规则：打开文件并获取 info，再调用 http.ServeContent(w, r, info.Name(), info.ModTime(), file)。modtime 描述的是“内容何时变化”，不是“这次请求何时发生”。

先把文件的真实修改时间取出来

ServeContent 的第四个参数是内容修改时间。对磁盘文件来说，最稳定的来源就是同一个已打开文件的 Stat 结果。示例把路径固定在服务端目录中，省略了与本文无关的路径映射逻辑：

func download(w http.ResponseWriter, r *http.Request) {
	// 打开后由同一个文件句柄读取元数据和内容，避免两次定位到不同文件。
	file, err := os.Open("./public/archive.iso")
	if err != nil {
		http.Error(w, "file unavailable", http.StatusNotFound)
		return
	}
	defer file.Close() // 响应结束后释放文件描述符。

	info, err := file.Stat()
	if err != nil {
		http.Error(w, "file metadata unavailable", http.StatusInternalServerError)
		return
	}

	// ServeContent 会根据文件名判断类型，并使用 ModTime 处理缓存条件。
	http.ServeContent(w, r, info.Name(), info.ModTime(), file)
}

这里的 info.ModTime() 同时服务于两个结果：普通响应中的 Last-Modified，以及客户端带来 If-Modified-Since 时的是否返回 304 Not Modified 判断。文件打开后没有提前读取，所以游标仍在开头；如果你的代码在调用前读过文件，应先执行 file.Seek(0, io.SeekStart)。

大文件为什么依然适合 ServeContent

大文件场景的关键不是把整个文件变小，而是让内容对象具备可定位的读取能力。ServeContent 会通过 Seek(0, io.SeekEnd) 获取长度，再回到开头；随后可以依据请求的 Range 返回部分内容。*os.File 正好实现了 io.ReadSeeker，因此文件数据仍由流式读取路径提供。

这也解释了两个常见边界：用只实现 io.Reader 的对象不能直接传入，内存缓冲区可以工作但会先承担装载成本；而文件句柄必须保持可读、可定位，不能在调用前关闭。图中只展示这些静态关系，不代表一次真实请求的执行截图。

如果内容来自对象存储或自定义后端，应提供可靠的 Seek 语义，或者改用能够直接控制范围响应的传输方案，不要把一个不可定位的网络流强行伪装成 io.ReadSeeker。

三种 modtime 写法的结果差异

还要注意，HTTP 日期的表达精度低于部分文件系统的时间精度。如果同一秒内替换了内容，仅靠 Last-Modified 可能不足以区分版本；需要更强的缓存判定时，可以在调用前设置符合 RFC 7232 的 ETag，让 ServeContent 参与相应的条件请求处理。

发布前的最小回归检查

先确认修改文件后再次 Stat 得到的时间确实变化，再检查普通响应是否有预期的 Last-Modified。随后用同一时间构造 If-Modified-Since 请求，观察是否能得到未修改结果；再用 Range: bytes=0-1023 检查大文件的范围响应和长度。代码、缓存代理和 CDN 都可能改变最终表现，所以检查时要区分源站响应与代理层响应。

• 传入的是文件内容的修改时间，而不是 time.Now()。
• 调用前内容对象仍位于开头，并且支持 Seek。
• 文件句柄在 ServeContent 完成前没有关闭，函数返回后由 defer 释放。
• 需要精细区分同秒更新时，额外设计稳定的 ETag。

相关问题

ServeContent 的 name 会决定下载文件名吗？

不会。官方说明中，name 主要用于扩展名推断 MIME 类型，名称本身不会作为响应文件名发送。

为什么 ServeContent 调用后文件位置变了？

它需要定位到文件末尾获取大小，再回到开头处理内容。不要复用一个已被其他并发逻辑随意移动游标的句柄；每个请求应拥有清晰的可定位读取对象。

不设置 modtime 能下载吗？

通常仍可返回内容，但不会获得基于有效 Last-Modified 的判断能力。只是不知道内容时间时才使用零值，不要把它当成默认优化选项。

总结：对于大文件，正确调用顺序是打开文件、读取同一文件句柄的 ModTime、确保内容可 Seek，最后交给 ServeContent。真正决定缓存是否可靠的，是传入的时间是否代表内容版本。