如何在Laravel Jobs中上传图片？遇UploadedFile序列化错误

你遇到的 Serialization of 'Illuminate\Http\UploadedFile' is not allowed 错误，核心原因是Laravel队列任务需要序列化所有传入的参数，而Illuminate\Http\UploadedFile对象无法被序列化。你虽然已经把图片保存到了Wasabi，但调用任务时传递了整个$request对象，而请求对象中包含了未被移除的UploadedFile实例，导致序列化失败。

解决步骤 #

1. 避免传递整个请求对象给任务

不要把$request直接传给队列任务，只提取任务需要的具体数据（字符串、数字、Eloquent模型等可序列化类型）。

2. 修改控制器代码

从请求中提取必要字段，仅传递这些字段给任务：

public function store(ThreadRequest $request)
{
    $imageName = time().'.'.$request->attachment->extension();
    $request->attachment->storeAs('public/attachments', $imageName, 'wasabi');

    // 仅传递任务需要的字段，而非整个request
    $this->dispatch(new CreateThread(
        $request->title,
        $request->body,
        $request->category_id,
        auth()->user(),
        $imageName
    ));

    return redirect()->route('threads.index');
}

3. 调整队列任务类

修改任务的构造函数，接收具体参数，并在handle方法中使用这些参数创建Thread：

use App\Models\Thread;
use App\Models\User;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Mews\Purifier\Facades\Purifier;

class CreateThread implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public function __construct(
        public string $title,
        public string $body,
        public int $categoryId,
        public User $author,
        public string $imageName
    ) {}

    public function handle(): Thread
    {
        $thread = new Thread([
            'title' => $this->title,
            'body' => Purifier::clean($this->body),
            'category_id' => $this->categoryId,
            'attachment' => $this->imageName, // 将图片名称存入thread
        ]);

        $thread->authoredBy($this->author);
        $thread->save();

        return $thread;
    }
}

关键说明 #

Laravel的SerializesModels trait会自动处理Eloquent模型的序列化（仅序列化ID，执行任务时重新查询模型），但像UploadedFile、Request这类无法序列化的对象，绝对不能作为任务的属性传递。始终确保队列任务的参数是简单类型（字符串、数字）或可序列化的模型实例。

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