Laravel 队列任务在后台进程（如 php artisan queue:work）中异步执行，此时 HTTP 请求上下文已不存在，request() 辅助函数将返回 null，导致访问 request()->organization 等属性时抛出“Trying to get property”的错误。正确做法是在任务创建时显式传入所需数据。

laravel 队列任务在后台进程（如 `php artisan queue:work`）中异步执行，此时 http 请求上下文已不存在，`request()` 辅助函数将返回 `null`，导致访问 `request()->organization` 等属性时抛出“trying to get property”的错误。正确做法是在任务创建时显式传入所需数据。

在 Laravel 中，队列任务运行于无请求上下文的环境中——它可能由 Horizon、Supervisor 或纯 CLI 进程触发，与原始 Web 请求完全隔离。因此，任何依赖 request()、session()、auth()（未显式传入凭证）等全局辅助函数的逻辑，在队列中都会失效。

✅ 正确实践：将必要数据作为构造参数注入任务类，而非在 handle() 方法中动态调用 request()。

例如，假设你有一个生成工资单 PDF 并发送邮件的队列任务：

// app/Jobs/SendPayslipEmail.php
<?php namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

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

    protected $organizationId;
    protected $userId;
    protected $month;

    // ✅ 在构造时接收关键数据（来自当前请求）
    public function __construct($organizationId, $userId, $month)
    {
        $this->organizationId = $organizationId;
        $this->userId = $userId;
        $this->month = $month;
    }

    public function handle()
    {
        // ✅ 安全使用传入的数据，无需 request()
        $organization = \App\Models\Organization::findOrFail($this->organizationId);

        $pdf = \App\Http\Services\Payslip::generate($organization, $this->userId, $this->month);

        \Mail::to('user@example.com')->send(new \App\Mail\PayslipMail($pdf, $organization));
    }
}

在控制器中分发任务时，从当前请求提取所需字段并传入：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

// 在控制器方法中
public function sendPayslip(Request $request)
{
    // ✅ 显式提取并传递，而非依赖 request() 在队列中可用
    SendPayslipEmail::dispatch(
        $request->organization->id,  // 或 $request->input('organization_id')
        $request->user()->id,
        $request->input('month', now()->format('Y-m'))
    )->onQueue('emails');

    return response()->json(['status' => 'queued']);
}

⚠️ 注意事项：

• 不要序列化 Request 对象本身（如 serialize($request)），因其包含不可序列化的资源（如 UploadedFile、Symfony Request 实例），极易引发异常；
• 若需复杂对象（如模型），优先传递 ID，并在 handle() 中重新查询（保障数据新鲜性与队列隔离性）；
• 使用 SerializesModels trait 可安全序列化 Eloquent 模型（仅序列化主键，反序列化时自动重载）；
• 开发阶段可通过 --sync 模式调试：php artisan queue:work --sync，但务必在生产环境切换为真实驱动（database/redis）。

总结：Laravel 队列不支持 request() 辅助函数，根本原因在于其脱离 HTTP 生命周期。坚持「显式传参、按需加载」原则，不仅能解决当前问题，更能提升任务的可测试性、可追溯性与健壮性。