Laravel Open-Admin图片上传裁剪报NotSupportedException错误求助

问题重现 #

在Laravel Open-Admin中原本可正常上传图片，添加裁剪功能后（使用crop()方法），出现以下错误：

NotSupportedException In AbstractEncoder.php line 200 :
Encoding format (tmp) is not supported.

控制器代码如下：

protected function form()
{
    $form = new Form(new Book());

    $form->text('name', __('Name'));
    $form->ckeditor('description', __('Description'));       
    $form->image('cover_photo', __('Cover photo'))->crop(800,800,50,50);
    return $form;
}

已尝试添加encode('jpg')、检查GD/Imagick扩展，均未解决，报错指向临时文件保存环节。

有效解决方案 #

方案1：强制指定编码格式与文件名规则 #

在crop()后明确指定编码格式，并开启唯一文件名生成（确保文件名带扩展名）：

$form->image('cover_photo', __('Cover photo'))
    ->crop(800, 800, 50, 50)
    ->encode('jpg') // 强制输出jpg格式
    ->uniqueName() // 自动生成带扩展名的唯一文件名
    ->move('uploads/book-covers'); // 指定最终存储路径

原理：临时文件默认无标准图片扩展名，Intervention无法识别格式，强制编码+带扩展名的文件名可解决识别问题。

方案2：自定义上传回调手动处理临时文件 #

如果方案1无效，可通过uploaded回调直接干预临时文件的处理流程：

$form->image('cover_photo', __('Cover photo'))
    ->uploaded(function ($file) {
        // 获取临时文件的真实路径
        $tmpFilePath = $file->getRealPath();
        // 使用Intervention裁剪并生成带扩展名的文件
        $image = \Intervention\Image\Facades\Image::make($tmpFilePath);
        $image->crop(800, 800, 50, 50)->encode('jpg');
        
        // 保存处理后的文件（覆盖原临时文件并添加扩展名）
        $processedPath = $tmpFilePath . '.jpg';
        $image->save($processedPath);
        
        // 更新上传文件对象的属性
        $file->move(dirname($tmpFilePath), basename($processedPath));
        $file->setClientOriginalExtension('jpg');
    })
    ->move('uploads/book-covers');

原理：直接修改临时文件的格式与扩展名，确保后续处理能正确识别图片格式。

方案3：检查Open-Admin上传配置 #

确认config/admin.php中的上传配置正确，尤其是磁盘与存储目录：

'upload' => [
    'disk' => 'admin',
    'directory' => [
        'image' => 'images/books',
        'file' => 'files',
    ],
],

同时检查config/filesystems.php中admin磁盘的配置，确保存储路径存在且可写：

'disks' => [
    // ...
    'admin' => [
        'driver' => 'local',
        'root' => public_path('uploads'),
        'url' => env('APP_URL').'/uploads',
        'visibility' => 'public',
    ],
],

问题根源 #

裁剪操作处理的临时文件默认使用.tmp扩展名，Intervention Image无法识别该格式，导致编码时抛出NotSupportedException。通过强制指定格式或修改临时文件扩展名，可让Intervention正确识别并处理图片。

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