使用Laravel队列后无法通过echo输出结果求助

核心原因 #

Laravel队列任务是后台异步执行的：

• 控制器调用dispatch()后，只是把任务推送到队列存储（数据库/Redis等），立刻给前端返回空响应，所以页面显示空白。
• 你在任务的handle()方法里用echo输出的内容，只会在执行任务的worker进程中打印，不会传递到前端页面。

解决步骤 #

1. 先确保队列Worker已启动

队列任务不会自动执行，必须启动Worker进程来消费队列：

# 启动Worker，执行一次队列任务后退出
php artisan queue:work

# 持续监听队列，适合开发环境
php artisan queue:listen

如果要查看任务执行的详细日志，启动时加上-vv参数：

php artisan queue:work -vv

2. 替换echo，改用持久化存储或日志记录

要获取任务执行的结果，不能直接echo，需要把结果存到数据库、缓存，或者写入日志：

示例1：用日志记录结果

修改任务类的handle()方法：

use Illuminate\Support\Facades\Log;

public function handle()
{
    $oClient = EmailClient::account('default');
    $oClient->connect();
    $folders = $oClient->getFolders("INBOX")->first();
    $fatture = Invoice::all();
    $messages = $folders->query()->since(now()->subDays(300))->get();

    foreach ($messages as $message) {
        if (str_contains($message->getSubject(), "Ricevuta")) {
            $value = strstr($message->getRawBody(), "<NomeFile>");
            $result = substr($value, 10, 24);
            
            foreach ($fatture as $fattura) {
                if ($fattura->nome_file == $result) {
                    // 写入日志，日志文件在 storage/logs/laravel.log
                    Log::info('匹配到的发票文件名：'.$result);
                }
            }
        }
    }
}

示例2：存储到数据库

1. 创建存储结果的模型和迁移：

php artisan make:model EmailExtractResult -m

2. 在迁移文件里添加字段：

public function up()
{
    Schema::create('email_extract_results', function (Blueprint $table) {
        $table->id();
        $table->string('file_name');
        $table->timestamps();
    });
}

3. 执行迁移：

php artisan migrate

4. 修改任务类的handle()方法：

use App\Models\EmailExtractResult;

public function handle()
{
    // ... 其他代码不变

    foreach ($messages as $message) {
        if (str_contains($message->getSubject(), "Ricevuta")) {
            $value = strstr($message->getRawBody(), "<NomeFile>");
            $result = substr($value, 10, 24);
            
            foreach ($fatture as $fattura) {
                if ($fattura->nome_file == $result) {
                    // 存储到数据库
                    EmailExtractResult::create(['file_name' => $result]);
                }
            }
        }
    }
}

之后可以在控制器里添加方法，查询这个表的结果返回给前端页面。

3. 调试队列任务

如果任务执行异常，可以通过以下方式排查：

• 查看Laravel日志文件（storage/logs/laravel.log）。
• 用php artisan queue:failed查看失败的任务，php artisan queue:retry 任务ID重试失败任务。

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