Go Fiber中defer os.Remove()未触发，临时文件无法删除求助

问题原因 #

1. defer执行时机与系统文件锁冲突：defer os.Remove(tempFile)确实会在函数返回时执行，但Windows系统下，即便你显式关闭了文件句柄，c.Send(b)发送数据的过程中（或系统缓存未释放文件资源），仍可能触发“文件正被占用”的错误。
2. 全内存读取的弊端：把整个文件读进内存再发送，既浪费内存，又拉长了文件被占用的时间窗口，进一步提升了删除失败的概率。

解决方案 #

方案1：流式发送（推荐）

直接通过io.Copy流式传输文件内容，发送完成后立即关闭文件并执行删除，最大化缩短文件资源占用时间：

func (h *Handler) Download(c *fiber.Ctx) error {
    filename := c.Query("filename")
    c.Attachment(filename)
    tempFile := filepath.Join(os.TempDir(), filename)

    // 打开目标文件
    file, err := os.Open(tempFile)
    if err != nil {
        return err
    }
    // 确保文件句柄最终释放
    defer file.Close()

    // 流式写入响应体
    if _, err := io.Copy(c.Response().BodyWriter(), file); err != nil {
        return er.Wrap(err)
    }

    // 发送完成后删除文件
    if err := os.Remove(tempFile); err != nil {
        // 记录删除失败日志，不影响客户端响应
        log.Printf("failed to delete temp file %s: %v", tempFile, err)
    }

    return c.SendStatus(fiber.StatusOK)
}

方案2：异步延迟删除（兼容极端场景）

如果流式发送仍偶发删除失败（比如系统缓存未及时释放），可以用goroutine延迟执行删除，不阻塞响应返回：

func (h *Handler) Download(c *fiber.Ctx) error {
    filename := c.Query("filename")
    c.Attachment(filename)
    tempFile := filepath.Join(os.TempDir(), filename)

    // 读取文件到内存
    b, err := ioutil.ReadFile(tempFile)
    if err != nil {
        return er.Wrap(err)
    }

    // 异步延迟删除文件
    go func() {
        time.Sleep(2 * time.Second)
        if err := os.Remove(tempFile); err != nil {
            log.Printf("failed to delete temp file %s: %v", tempFile, err)
        }
    }()

    return c.Send(b)
}

关键注意事项 #

• 优先选择流式发送：既节省内存，又能让文件句柄快速释放，从根源降低删除失败的可能性。
• 不要忽略删除失败日志：即便删除操作不影响业务流程，也要记录日志便于后续排查问题。
• 适配Windows文件锁机制：Windows对文件资源的锁定更严格，必须确保所有关联句柄都已关闭后再执行删除。

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