在PHPUnit测试中执行Artisan::call或shell_exec无输出不生效问题

API 探路者

2026-10-5

问题原因

输出捕获机制：PHPUnit默认会拦截所有程序输出，Artisan::call的输出不会直接打印到终端，需要手动调用Artisan::output()获取；shell_exec的返回值也需要手动打印才会显示。
queue:work常驻特性：原生的queue:work是常驻进程命令，会持续监听队列不会自动退出，执行后会卡住PHPUnit单测进程直到超时被强制终止，自然不会有返回结果和输出。
测试环境配置差异：Laravel运行PHPUnit时会优先加载phpunit.xml中定义的环境变量，多数项目默认会把测试环境的QUEUE_CONNECTION设为sync或null，前者不需要worker即可同步执行任务，后者会直接丢弃队列任务，都会让worker看起来没有执行效果。
shell_exec上下文不匹配：PHPUnit执行时的工作目录、PHP可执行文件路径、系统环境变量可能和普通命令行环境不一致，直接写php artisan可能找不到对应的文件，执行失败也没有输出。

解决方案

调整Artisan调用参数并手动获取输出：给queue:work增加--stop-when-empty参数，处理完队列中已有任务后自动退出，避免卡住；执行后手动打印输出：

/**
 * @test
 */
public function xxx()
{
   $exitCode = Artisan::call('queue:work', [
       '--stop-when-empty' => true,
       '--timeout' => 5
   ]);
   echo Artisan::output();
}

修正测试环境队列配置：打开项目根目录的phpunit.xml文件，确认QUEUE_CONNECTION的配置值为你实际要使用的队列驱动（如redis、database），不要设置为null。
补全shell_exec的路径参数：使用绝对路径避免上下文差异，同时把错误输出重定向到标准输出方便排查问题：

/**
 * @test
 */
public function xxx()
{
   $command = sprintf(
       '%s %s queue:work --stop-when-empty 2>&1',
       PHP_BINARY,
       base_path('artisan')
   );
   $output = shell_exec($command);
   echo $output;
}

优先使用队列伪造测试：如果你的测试目的只是验证队列任务是否被正确推送，不需要实际执行任务，直接使用Laravel自带的队列伪造功能即可，无需调用worker命令：

use Illuminate\Support\Facades\Queue;
use App\Jobs\YourJob;

/**
 * @test
 */
public function xxx()
{
    Queue::fake();
    // 执行触发队列推送的业务代码
    Queue::assertPushed(YourJob::class);
}

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