Laravel中同时保存原始图片和转换后WebP图片出现写入错误如何解决

排查步骤 #

• 检查目录权限与软链：首先确认storage/app/public目录对web服务运行用户有写入权限，可执行命令sudo chmod -R 755 storage、sudo chown -R www-data:www-data storage授权，同时确认已执行php artisan storage:link创建存储目录软链。
• 检查路径正确性：你代码中直接给Intervention的save()方法传入相对路径public/images/xxx，Intervention是基于服务器物理路径写入，这个相对路径无法匹配到Laravel的storage存储目录，需要生成绝对物理路径。
• 检查扩展支持：确认服务器的GD/Imagick扩展开启了WebP支持，可通过phpinfo()查看对应扩展的WebP支持状态为启用，未开启的话重新编译扩展添加WebP编译参数即可。
• 检查变量覆盖问题：你代码中先创建了Image模型实例赋值给$image变量，后续调用Intervention处理时又把返回值赋值给$image，会覆盖原有模型实例，导致后续的update()操作报错。

现有代码修复 #

将WebP保存的相关代码替换为以下内容即可：

// 生成webp文件名（去掉原始后缀加.webp）
$webpName = pathinfo($name, PATHINFO_FILENAME) . '.webp';
// 生成Laravel storage下的绝对物理路径，和原始文件存在同一分级目录便于管理
$webpAbsolutePath = storage_path('app/public/images/article-images/'.$image->id.'/' . $webpName);

// 处理图片：先resize再encode性能更优，不要覆盖原有$image模型变量
InterventionImage::make($mediaFiles)
    ->resize(200, 250)
    ->encode('webp', 90)
    ->save($webpAbsolutePath);  

// 如果需要存webp的访问路径，可给images表新增webp_path字段更新入库
$image->update([
    'path' => substr($path, 7),
    'webp_path' => 'images/article-images/'.$image->id.'/' . $webpName
]);

替代实现方案 #

• 用Laravel Storage门面统一写入：适配Laravel的文件存储配置，不用手动处理物理路径，逻辑更统一：

$webpContent = InterventionImage::make($mediaFiles)
    ->resize(200, 250)
    ->encode('webp', 90)
    ->__toString();
Storage::put('public/images/article-images/'.$image->id.'/'.$webpName, $webpContent);

• 用spatie/laravel-medialibrary扩展包管理媒体资源：配置好衍生图转换规则后，可自动生成WebP等多格式图片，无需手动编写编码、存储逻辑，还自带媒体关联、清理等能力。

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