Laravel队列作业中获取上传文件返回Null问题求助

队列Job是异步执行的，完全脱离了原HTTP请求的上下文——当Job开始运行时，用户上传文件的那个请求早就结束了，所以在Job里调用request()->file('file')，拿到的根本不是上传时的请求实例，自然返回null。

你需要先把上传的文件存到服务器存储里，再把文件路径传给Job，让Job通过路径读取内容。具体修改步骤如下：

1. 修改控制器：先保存上传文件 #

在import方法里，先把用户上传的文件存到存储目录，再把路径传入Job：

public function import(ImportPointRequest $request)
{
    Storage::makeDirectory('import_logs');
    $file        = request()->file('file');
    // 生成唯一文件名，避免重复覆盖
    $storedFileName = 'uploads/' . uniqid() . '.' . $file->getClientOriginalExtension();
    // 保存文件到本地存储（可根据需求切换磁盘，比如S3）
    $file->storeAs('', $storedFileName, 'local');

    $fileName    = 'importlog_date_' . date('Y-m-d') . '-user_' . auth()->id() . '.xlsx';
    $logFile     = 'import_logs/' . $fileName;
    $readerTypes = ['xlsx' => Excel::XLSX, 'xls' => Excel::XLS, 'csv' => Excel::CSV];
    $link        = route('file.show', ['import_logs', $fileName]);

    try {
        ExcelFacade::import(new PointsImportHeading(), $file);
    } catch (\Exception $e) {
        // 验证失败时，记得删除已存的文件
        Storage::disk('local')->delete($storedFileName);
        return $this->returnBadRequest(config('point.error-codes.import-fail'), $e->getMessage());
    }

    // 把存储路径传给Job，替代原来的realPath
    (new PointsImport(auth()->user(), auth()->user()->account_id, $logFile, $storedFileName))->queue(
        null,
        null,
        $readerTypes[$file->getClientOriginalExtension()]
    )->chain([new AfterImportJob(auth()->id(), $logFile, $link)]);

    return $this->returnSuccess(trans('point::point.import-queued', ['module' => trans('point::point.point')]));
}

2. 修改PointsImport Job：接收文件路径 #

更新Job的构造函数，新增文件路径参数并保存为类属性：

class PointsImport implements ShouldQueue
{
    protected $user;
    protected $accountId;
    protected $logFile;
    protected $storedFilePath;

    public function __construct(User $user, int $accountId, string $logFile, string $storedFilePath)
    {
        $this->user = $user;
        $this->accountId = $accountId;
        $this->logFile = $logFile;
        $this->storedFilePath = $storedFilePath;
    }

    // ... 其他原有方法
}

3. 调整Job读取文件的方法 #

把getUploadedFileContent改成通过路径读取，不再依赖request：

protected function getUploadedFileContent(): array
{
    // 获取文件的完整服务器路径
    $filePath = Storage::disk('local')->path($this->storedFilePath);
    return Excel::toArray(new PointsImportHeading(), $filePath);
}

4. 可选：Job执行后清理文件 #

如果不需要保留上传的源文件，可以在Job执行完成后删除，避免占用存储：

public function handle()
{
    // ... 你的业务逻辑代码

    // 执行完毕后删除文件
    Storage::disk('local')->delete($this->storedFilePath);
}

• 如果用的是云存储（比如AWS S3），只需要把代码里的local磁盘换成对应配置即可，逻辑完全通用。
• 确保存储目录有足够的读写权限，避免文件保存或读取失败。

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