Intervention Image v3.7上传报错“Unable to decode input”求解决

错误原因 #

Intervention Image v3的ImageManager::read()方法不支持直接传入Laravel的UploadedFile实例，它仅接受文件路径、文件资源流或二进制图像数据，直接传递UploadedFile对象会导致解码失败，抛出Unable to decode input错误。

修正方案 #

将UploadedFile转换为临时文件路径传入read()方法即可解决问题，以下是完整修正代码：

修正后的Controller #

public function upload(Request $request)
{
    try {
        $filePath = 'banners/';

        if (app()->environment('local')) {
            $filePath = 'local/' . $filePath;
        }

        // 提前验证文件有效性
        if (!$request->hasFile('file') || !$request->file('file')->isValid()) {
            return response()->json([
                'message' => 'Invalid file',
                'detail' => 'Please upload a valid image file'
            ], 400);
        }

        // 可选：添加文件格式和大小验证
        $request->validate([
            'file' => 'required|image|mimes:jpg,jpeg,png,webp|max:10240',
        ]);

        $file = ImageService::processImage($request->file('file'), $filePath, 1920, 1080);

        return response()->json([
            'message' => 'Banner uploaded successfully',
            'url' => $file
        ]);

    } catch (\Exception $e) {
        return response()->json([
            'message' => 'An error occurred',
            'detail' => $e->getMessage()
        ], 500);
    }
}

修正后的ImageService #

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver; // 若使用Imagick则替换为Drivers\Imagick\Driver
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Illuminate\Http\UploadedFile;
use Intervention\Image\Encoders\JpegEncoder;

class ImageService
{
    public static $maxSize = 10485760; // 10MB
    public static $defaultWidth = 1280;
    public static $defaultHeight = 720;

    public static function processImage(UploadedFile $file, string $path, ?int $width = null, ?int $height = null)
    {
        try {
            $fileName = auth()->id() . '_' . Str::random(40) . '_' . time() . '.jpg';
            $filePath = $path . $fileName;
            
            $manager = new ImageManager(Driver::class);

            // 关键修正：传入文件临时路径而非UploadedFile对象
            $image = $manager->read($file->getRealPath());

            // 处理尺寸调整逻辑
            if ($file->getSize() > self::$maxSize || $width !== null || $height !== null) {
                if ($width !== null && $height === null) {
                    $image->resize(width: $width);
                } elseif ($width === null && $height !== null) {
                    $image->resize(height: $height);
                } else {
                    $image->resize(
                        width: $width ?? self::$defaultWidth,
                        height: $height ?? self::$defaultHeight
                    );
                }
            }

            $encoded = $image->encode(new JpegEncoder(quality: 75));
            Storage::put($filePath, $encoded, 'public');

            return Storage::url($filePath); // 返回可直接访问的URL，可根据需求替换为存储路径
        } catch (\Exception $e) {
            \Illuminate\Support\Facades\Log::error('PROCESS IMAGE ERROR: ' . $e->getMessage());
            throw $e; // 抛出异常交由Controller统一处理
        }
    }
}

额外注意事项 #

• 驱动适配：确保服务器安装了对应驱动的扩展（Gd或Imagick），并在代码中引入正确的驱动类。
• 文件验证：务必添加文件类型和大小验证，避免传入非图像文件引发解码错误。
• 异常处理：Service层不要使用dd()中断流程，应抛出异常让上层Controller统一返回响应。

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