PHP使用libvips出现内存泄漏及GLib报错问题咨询

算力阿峰

2026-8-26

问题根因

你当前使用的是Apache prefork模式下的常驻PHP工作进程，libvips依赖的GObject类型系统、操作缓存、内部内存池默认设计为进程退出时才执行完整回收。Apache工作进程处理完单次请求后不会销毁，会持续驻留等待下一个请求，因此libvips处理图片时申请的堆内存、缓存的解码/处理中间资源会一直残留在进程地址空间，多次请求后就会出现可用内存持续下跌、无法自动释放的现象。
日志里的cannot register existing type 'VipsObject'系列GLib报错，来自php-vips 2.0.3版本的已知逻辑缺陷：该版本没有在请求级别正确判断libvips的初始化状态，当同一个Apache进程处理多个PHP请求时，会重复触发GType注册流程，不仅抛出警告，还会重复创建类型对象、缓存结构，进一步加剧内存泄漏。
手动调用Vips\Config::shutDown();后内存正常释放，是因为该方法会主动触发libvips的全局清理逻辑：销毁所有操作缓存、释放类型系统持有的对象、回收内部内存池资源，刚好补上了默认流程中请求结束后无主动清理的缺口。

修复方案

显式增加清理逻辑：在所有libvips图片处理逻辑执行完成后，主动调用Vips\Config::shutDown();释放资源。为了避免遗漏，可以通过PHP的注册关闭函数做全局统一处理，不需要在每个业务点单独写调用：

<?php
// 全局注册请求结束时的libvips清理逻辑
register_shutdown_function(function() {
    if (class_exists('Jcupitt\Vips\Config') && Vips\Config::isInitialized()) {
        Vips\Config::shutDown();
    }
});

注意不要在还有Vips图片对象存活时调用shutdown方法，否则会触发段错误。

升级修复已知bug：当前使用的php-vips 2.0.3版本过旧，升级到2.2.0及以上稳定版本即可修复重复初始化GObject类型的问题，新版本优化了请求级别的内存自动回收逻辑，绝大多数场景下不需要强制手动调用shutdown也能正常释放中间内存。如果环境允许，可以同时将libvips从源里的8.12.1版本升级到8.14及以上的LTS版本，新版本对内存池回收逻辑做了大量优化，常驻进程场景下的内存残留问题会有明显改善。
调整Apache进程回收策略：编辑prefork模块配置文件/etc/apache2/mods-available/mpm_prefork.conf，设置MaxRequestsPerChild 100，让每个工作进程处理100个请求后自动退出重建，避免单个进程长期运行累积的内存碎片、残留资源占用过高。该值不建议设置低于50，否则频繁创建销毁进程会带来额外CPU开销。
优化图片处理逻辑减少内存占用：当前代码使用的thumbnail_image方法需要先全量加载原图到内存再做缩放，本身内存开销较高，替换为直接从文件生成缩略图的thumbnail接口，可以从源头减少内存申请量，单次请求内存占用可降低70%以上：

<?php
$image = Vips\Image::thumbnail($inputImagePath, $width, [
    'height' => $height,
    'crop' => 'centre'
]);
$image->writeToFile($outputImagePath, ['Q' => $quality]);

该接口会在解码阶段就按目标尺寸按需加载像素数据，不会将全尺寸原图完整读入内存。

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