Laravel图片上传及缩放报错（Postman测试）

我正在用VS Code里的Postman 0.12.1插件测试Laravel的图片上传与缩放功能，遇到了无法解决的错误，希望得到指引。以下是相关代码文件内容：

GalleryRepository代码 #

public function create(array $data)
{
    try{
        return DB::transaction(function()use($data){
            // Define the maximum width and height
            $maxWidth = 1000;
            $maxHeight = 1000;
            // resize the image while maintaining the aspect ratio
            $data['name'] = request('name')->resize($maxWidth, $maxHeight, function($constraint) {
                $constraint->aspectRatio();
                $constraint->upsize(); // prevent the image from upscaling
            });

            $subfolder = date('Y') . '/' . date('m');
            $img_path = "assets/img/{$data['type']}/gallery/{$subfolder}";
            $data['name'] = $data['name']->store($img_path, 'public');
            return Gallery::create($data);
        });
    }catch(Exception $error){
        $message = $error->getMessage()??"INSERT_ERR";

        /**
         * known code error db
         * 23000 duplicate entry
         * @see https://dev.mysql.com/doc/mysql-errors/8.0/en/server-error-reference.html
         */
        if($error->getCode()==='23000'){
            $message = "ERR_DUPLICATE_ENTRY";
        }

        return ['status'=>'ERR','message'=>$error];
    }
}

StoreGalleryRequest代码 #

public function rules(): array
{
    return [
        'name' => 'required|image|mimes:jpg,png',
    ];
}

protected function passedValidation(): void
{
    $data = $this->validated();

    $this->replace($data);
}

问题分析与修复方案 #

1. 图片处理对象调用错误
   代码中直接使用request('name')->resize()是错误的，验证后的文件对象已经在$data['name']中，且需要通过Intervention Image实例化后才能调用缩放方法。

2. 缺少Intervention Image初始化
   要使用图片缩放功能，必须先通过Image::make()将上传的文件转为可处理的图片实例，确保已安装并配置Intervention Image扩展。

3. 异常返回值错误
   catch块中返回$error对象会导致序列化问题，应该返回错误信息字符串$message。

4. 冗余的请求验证处理
   passedValidation方法中的$this->replace($data)完全多余，Laravel验证后的数据会自动绑定到请求中。

5. 缺失必填字段验证
   代码中用到了$data['type']，但请求规则中未验证该字段，需补充规则避免路径拼接错误。

修复后的GalleryRepository代码

public function create(array $data)
{
    try{
        return DB::transaction(function()use($data){
            $maxWidth = 1000;
            $maxHeight = 1000;
            
            // 实例化图片并执行缩放
            $image = \Intervention\Image\Facades\Image::make($data['name']);
            $image->resize($maxWidth, $maxHeight, function($constraint) {
                $constraint->aspectRatio();
                $constraint->upsize();
            });

            $subfolder = date('Y') . '/' . date('m');
            $imgPath = "assets/img/{$data['type']}/gallery/{$subfolder}";
            $storagePath = public_path($imgPath);
            
            // 确保存储目录存在
            if(!file_exists($storagePath)) {
                mkdir($storagePath, 0755, true);
            }
            
            // 生成唯一文件名并保存图片
            $fileName = uniqid() . '.' . $data['name']->getClientOriginalExtension();
            $image->save($storagePath . '/' . $fileName);
            
            // 存储路径到数据库
            $data['name'] = $imgPath . '/' . $fileName;
            
            return Gallery::create($data);
        });
    }catch(\Exception $error){
        $message = $error->getMessage() ?? "INSERT_ERR";

        if($error->getCode() === '23000'){
            $message = "ERR_DUPLICATE_ENTRY";
        }

        return ['status'=>'ERR','message'=>$message];
    }
}

简化后的StoreGalleryRequest代码

public function rules(): array
{
    return [
        'name' => 'required|image|mimes:jpg,png',
        'type' => 'required|string', // 补充type字段验证
    ];
}

// 移除多余的passedValidation方法

额外注意事项 #

• 执行composer require intervention/image安装图片处理扩展，并在config/app.php中注册服务提供者和门面。
• 确保public/assets/img/目录存在且拥有0755权限，避免存储失败。
• Postman请求中必须传入type字段，否则会导致路径拼接错误。

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