Golang HTTP服务器文件缓存问题：高频更新HLS索引文件排查

这问题我之前做低延迟HLS直播的时候踩过完全一样的坑！核心就是从Go服务器到客户端播放器的多层缓存在拖后腿，咱们一步步拆解解决：

1. 彻底禁用Go服务器端的HTTP缓存头 #

http.ServeFile默认会自动添加Last-Modified和ETag响应头，客户端（浏览器/播放器）会用这些字段发起If-Modified-Since条件请求——如果服务器判断文件“没修改”（其实是修改时间的缓存判断有延迟），就返回304让客户端用本地缓存，这是最常见的元凶。

解决办法是放弃http.ServeFile的默认行为，手动读取文件并强制设置禁用缓存的响应头：

http.HandleFunc("/live.m3u8", func(w http.ResponseWriter, r *http.Request) {
    // 强制客户端每次都重新请求，绝不缓存
    w.Header().Set("Cache-Control", "no-store, no-cache, must-revalidate, max-age=0")
    w.Header().Set("Pragma", "no-cache")
    w.Header().Set("Expires", "Thu, 01 Jan 1970 00:00:00 GMT")
    // 设置正确的HLS索引文件MIME类型
    w.Header().Set("Content-Type", "application/vnd.apple.mpegurl")

    // 每次请求都重新读取最新文件内容
    content, err := os.ReadFile("./path/to/your/live.m3u8")
    if err != nil {
        http.Error(w, "Failed to load playlist", http.StatusInternalServerError)
        return
    }
    w.Write(content)
})

2. 保证文件更新的原子性与磁盘同步 #

你已经调用了Sync()，但如果更新文件的方式不对，还是会出现客户端读到不完整内容或者旧文件的情况。正确的姿势是原子替换文件，而不是直接覆盖：

import "path/filepath"

func updateHLSPlaylist(newContent string) error {
    tempFile := "./live.m3u8.tmp"
    targetFile := "./live.m3u8"

    // 1. 写入临时文件
    f, err := os.Create(tempFile)
    if err != nil {
        return err
    }
    defer f.Close()

    if _, err := f.WriteString(newContent); err != nil {
        return err
    }
    // 确保文件内容同步到磁盘（而不是停留在内核缓存）
    if err := f.Sync(); err != nil {
        return err
    }

    // 2. 原子替换目标文件（跨平台安全，Windows下也能保证原子性）
    if err := os.Rename(tempFile, targetFile); err != nil {
        return err
    }

    // 3. 同步目录（Linux/Unix下必须，确保目录元数据更新到磁盘）
    dir, err := os.Open(filepath.Dir(targetFile))
    if err != nil {
        return err
    }
    defer dir.Close()
    return dir.Sync()
}

这种方式能保证客户端要么读到旧的完整文件，要么读到新的完整文件，不会出现半写的中间态，同时目录同步能让内核立刻感知到文件的变化。

3. 禁用客户端播放器的缓存 #

很多HLS播放器（比如hls.js、原生AVPlayer）默认会缓存索引文件和分片，哪怕服务器返回了禁用缓存的头。需要在播放器端手动配置：

• hls.js 可以通过xhrSetup强制添加无缓存请求头，同时降低缓冲长度：

  const hls = new Hls({
    lowLatencyMode: true, // 开启低延迟模式
    maxBufferLength: 0.5, // 把缓冲长度压到最低
    xhrSetup: (xhr) => {
      xhr.setRequestHeader('Cache-Control', 'no-cache');
    }
  });
  

• iOS AVPlayer 可以设置preferredForwardBufferDuration为极小值，或者通过AVAssetResourceLoader自定义请求头。

4. 避免Go进程内的文件句柄缓存 #

如果你的代码中提前打开了HLS索引文件的句柄并复用，那即使文件被原子替换了，Go进程持有的句柄还是指向旧的文件inode（Linux/Unix下）。一定要每次请求都重新读取文件，绝对不要复用文件句柄！

比如这种写法是错误的：

// 错误示例：提前打开文件，后续文件替换后句柄仍指向旧文件
f, _ := os.Open("./live.m3u8")
http.HandleFunc("/live.m3u8", func(w http.ResponseWriter, r *http.Request) {
    f.Seek(0, io.SeekStart)
    http.ServeFile(w, r, f.Name())
})

把上面几点都落实后，应该就能实现近乎零延迟的HLS索引文件更新了！

内容的提问来源于stack exchange，提问作者Rob