生产环境生命周期管理

govips 包装的是 C 库（libvips），所以资源管理比纯 Go 程序更复杂。每一个打开的图片都对应 libvips 内部分配的内存——漏掉一个 Close() 就意味着泄漏数千到数百万像素的 VRAM/RAM。

进程级生命周期

func main() {
    // 1. 初始化 — 必须检查错误
    if err := vips.Startup(nil); err != nil {
        log.Fatalf("start libvips: %v", err)
    }
    defer vips.Shutdown()

    // 2. 服务循环
    server.Run()
}

Startup(nil) 每个进程只调用一次。初始化 GLib 类型系统和 libvips 内部状态。v2.18.0 起 Startup 可能返回错误（之前版本内部 panic）。
Shutdown() 释放所有 libvips 全局资源、清理缓存、关闭线程池。
确保 defer Shutdown()，即使在 panic 后也要调用。

ImageRef 生命周期

func handler(w http.ResponseWriter, r *http.Request) error {
    image, err := vips.NewImageFromFile(r.URL.Query().Get("path"))
    if err != nil {
        return fmt.Errorf("load: %w", err)
    }
    defer image.Close()

    if err := image.Resize(0.5, vips.KernelLanczos3); err != nil {
        return fmt.Errorf("resize: %w", err)
    }
    // image 在 handler 返回时自动 Close
    return nil
}

每个 ImageRef 分配 libvips 内存。
defer image.Close() 是惯用 Go 模式。
不要在 Close 之后再使用 image——libvips 可能 segfault 或返回损坏数据。

正确模式

func process(input string) ([]byte, error) {
    image, err := vips.NewImageFromFile(input)
    if err != nil {
        return nil, err
    }
    defer image.Close()

    if err := image.AutoRotate(); err != nil {
        return nil, err  // image.Close() 通过 defer 自动执行
    }
    buf, _, err := image.ExportJpeg(vips.NewJpegExportParams())
    return buf, err
}

错误模式

func process(input string) ([]byte, error) {
    image, _ := vips.NewImageFromFile(input)  // BAD: 忽略错误
    defer image.Close()                         // defer 已正确放置
    image.Close()                               // BAD: 过早关闭 — 但 defer 仍会在退出时 double-close
    return image.ExportJpeg(nil)                // BAD: 关闭后使用 — segfault
}

func process(input string) ([]byte, error) {
    image, err := vips.NewImageFromFile(input)
    if err != nil {
        return nil, err
    }
    // 忘记 Close — 每次调用泄漏内存
    return image.ExportJpeg(nil)
}

泄漏检测（v2.18.0+）

govips v2.18.0 引入了泄漏检测工具：

OpenImageRefs() 返回当前未关闭的 ImageRef 数量（用于开发/调试）。
AssertNoLeaks(t) 在测试结束时断言无泄漏——配合 go test 使用。

func TestResize(t *testing.T) {
    defer vips.AssertNoLeaks(t)  // 测试结束时会检查

    image, err := vips.NewImageFromFile("input.jpg")
    if err != nil {
        t.Fatal(err)
    }
    defer image.Close()
    // ...
}

Panic / Error 边界

govips 在以下情况可能产生 panic：

ImageRef 在 Close 后继续使用（double free）。
cgo 调用在 libvips 未初始化时（忘记调用 Startup）。
传递给 C 的 Go 切片被 GC 回收（v2.19.0 之前，SetBlob 存在此 bug；已修复）。

防御措施：在所有 goroutine 的入口使用 recover，将 panic 转为错误日志。不要指望 panic 后 libvips 状态仍然一致。

生产检查清单

Startup(nil) 的返回值被检查。
Shutdown() 放在 main 的 defer 中。
每个 NewImageFromFile/NewImageFromBuffer 的错误被检查。
每个 ImageRef 都有 defer Close() 或显式关闭。
Close 之后从不访问 ImageRef。
在高并发下测量 MALLOC_ARENA_MAX=2 的效果。
测试中加入 AssertNoLeaks(t)。
服务进程中设置 goroutine panic 恢复机制。