Laravel Horizon通过可视化仪表盘监控Redis队列，需安装包并发布配置文件，设置QUEUE_CONNECTION=redis，配置Redis连接信息，定义horizon.php中的工作进程策略，启动php artisan horizon服务，限制访问权限后即可查看任务状态、失败日志及吞吐量。

Laravel Horizon 是一个优雅的 Redis 队列监控和管理工具，它为 Laravel 的队列系统提供了可视化的仪表盘，能实时查看任务处理情况、失败任务、吞吐量、工作进程状态等。要配置和使用 Horizon 监控 Redis 队列，需完成几个关键步骤。

安装和配置 Horizon

要在 Laravel 项目中启用 Horizon，先通过 Composer 安装包：

安装完成后，发布 Horizon 的配置文件和资源：

这会生成 config/horizon.php 配置文件，用于定义工作进程环境、队列平衡策略、速率限制等。

配置 Redis 连接

确保 .env 文件中的 QUEUE_CONNECTION 设置为 redis：

同时在 config/database.php 中确认 Redis 配置正确，例如：

'redis' => [
    'client' => 'predis',
    'default' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => 0,
    ],
],

Horizon 使用 Redis 存储队列数据，因此必须确保 Redis 正常运行且可连接。

配置 Horizon 工作环境

打开 config/horizon.php，可以设置不同环境下（如 local、production）的工作进程数量和监听的队列。例如：

'environments' => [
    'local' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default'],
            'balance' => 'auto',
            'processes' => 3,
            'tries' => 3,
        ],
    ],
],

上面配置表示在本地环境中启动一个名为 supervisor-1 的工作进程组，使用 redis 连接，监听 default 队列，最多开启 3 个进程，每个任务最多尝试 3 次。

启动 Horizon 服务

使用以下命令启动 Horizon：

该命令会启动 Horizon 的守护进程，开始监听 Redis 中的队列任务。你可以通过 Supervisor 等进程管理工具将其常驻后台运行。

访问 Horizon 仪表盘，默认路径是 /horizon。你可以在 routes/web.php 或服务提供者中控制访问权限：

Horizon::auth(function ($request) {
    return app()->environment('local') || $request->user()?->hasRole('admin');
});

这样可以限制只有管理员或本地环境才能访问监控页面。

查看队列状态和调试任务

进入 Horizon 仪表盘后，可以看到：

• 当前活跃的任务数
• 最近处理的任务列表
• 失败任务日志及重试功能
• 每秒处理任务的吞吐量
• 各工作进程的状态和内存使用

如果某个任务失败，Horizon 会自动记录到 failed_jobs 表，你可以在界面上点击重试，或使用命令行清理：

此命令清除当前所有待处理和失败任务（谨慎使用）。

基本上就这些。配置好 Horizon 后，Redis 队列变得可视化、易管理，特别适合中大型项目中的异步任务监控。只要确保 Redis 稳定、队列驱动正确，并合理设置工作进程数，就能高效利用 Horizon 提升运维效率。