装不上 spatie/image-optimizer 主因是缺失系统依赖和 PHP 配置问题：需启用 proc_open、PHP ≥ 7.4、安装 pngquant/gifsicle 等二进制工具，并确认自动加载与类名正确。
composer require spatie/image-optimizer 装不上？先确认 PHP 环境和扩展
装不上 spatie/image-optimizer，90% 是因为缺依赖——它本身不处理图片，只调用外部二进制工具（比如 pngquant、gifsicle），而这些工具需要系统级支持。PHP 必须启用 proc_open 函数（默认开启，但某些共享主机或安全加固环境会禁用），且不能在 disable_functions 里。
实操建议：
- 运行
php -i | grep disable_functions查看是否禁用了proc_open - 检查
php -v输出，确保 PHP ≥ 7.4（该包最低要求） - Linux/macOS 下终端执行
which pngquant或which gifsicle，至少得有其中一两个存在；Windows 用户需手动下载对应 .exe 并加到PATH - 如果只是想快速试用，先用
composer require spatie/image-optimizer --with-all-dependencies避免因依赖冲突中断
为什么 new Optimizer() 报错 Class not found？自动加载没生效
装完包后直接 new Optimizer() 报错，大概率是类名写错了——这个包的主优化器类叫 SpatieImageOptimizerOptimizer，不是 ImageOptimizer 或其他变体。Laravel 用户还容易混淆：它和 spatie/laravel-image-optimizer 是两个包，后者才提供 Facade 和配置发布能力。
实操建议：
- 确认
use SpatieImageOptimizerOptimizer;已写在文件顶部 - 非 Laravel 项目，别指望自动发现配置，必须手动传入优化器列表，例如：
new Optimizer(['pngquant', 'optipng']) - Laravel 用户若想用
ImageOptimizer::optimize()，得额外装spatie/laravel-image-optimizer，再执行php artisan vendor:publish --provider="SpatieLaravelImageOptimizerImageOptimizerServiceProvider" - 检查
vendor/composer/autoload_psr4.php是否包含"Spatie\ImageOptimizer\"映射，没有说明 autoload 损坏，可删掉vendor/和composer.lock重装
optimize() 后图片没变小？路径、权限、工具链全要对得上
调用 $optimizer->optimize($path) 返回成功，但文件体积纹丝不动，常见于三类断点：路径指向的是原始文件而非副本、目标文件不可写、或者指定的优化器根本没生效（比如传了 ['jpegtran'] 却去压 PNG）。
实操建议：
-
$path必须是绝对路径（__DIR__ . '/img/photo.png'），相对路径容易因工作目录不同失效 - 确保 PHP 进程对文件及其所在目录有读写权限（Linux 常见问题：
chown -R www-data:www-data storage/） - 不要盲目堆参数，先用最简配置验证：
(new Optimizer(['pngquant']))->optimize($path)，再逐步加其他工具 - 查看返回值：
$optimizer->getLastCommand()可拿到实际执行的 shell 命令，复制出来手动跑一遍，看报什么错（比如pngquant: command not found）
在 Laravel 中批量压缩上传图片？别在 request 里直接 optimize()
用户上传图片后立刻调用 optimize()，看似合理，但实际容易卡住响应——每个优化器都是子进程，耗时不可控，尤其多图并发时。更糟的是，如果前端没做预压缩，一张 5MB 的 JPG 经 jpegtran 处理可能仍要 2~3 秒，超时风险高。
实操建议：
- 上传后先存原始图，用 Laravel 的
dispatch(new OptimizeImageJob($path))丢进队列异步处理 - Job 中加 try/catch + 日志，避免单张失败阻塞整批；同时检查
$optimizer->getLastOutput()判断是否真有压缩效果（有些图已最优，输出为空） - 生产环境务必限制并发数，比如 Supervisor 配置
processes=2，防止大量子进程吃光内存 - 别忘了清理临时文件：优化前最好
copy($original, $temp)，优化后再rename($temp, $original)，避免原始文件被意外锁住或损坏
真正麻烦的从来不是 composer require 那一行命令，而是路径权限、工具版本、进程资源这三块拼图凑不齐时，错误信息又藏在子进程 stdout 里——得靠 getLastCommand() 和 getLastOutput() 手动捞出来看。
