laravel Horizon提供可视化队列管理，通过安装配置后启用redis队列监控，支持实时查看任务状态、失败日志与性能指标，可设置优先级、进程策略及访问权限，并结合优化建议提升系统稳定性。
Laravel Horizon 提供了一套优雅的仪表盘和代码驱动的方式来监控和管理 Laravel 的 redis 队列系统。它不仅能实时展示队列的运行状态，还能帮助你优化任务处理效率、排查失败任务以及设置合理的进程调度策略。
安装与配置 Horizon
要在项目中启用 Horizon，先通过 composer 安装：
composer require laravel/horizon
安装完成后，发布 Horizon 的资源文件：
php artisan horizon:install
这会生成配置文件 config/horizon.php，你可以在此定义工作进程数量、队列优先级、平衡策略等。
确保你的 .env 文件中的 QUEUE_CONNECTION 设置为 redis，并正确配置 Redis 连接信息。
启动 Horizon 服务
运行以下命令启动 Horizon 监听器：
php artisan horizon
该命令会根据配置启动多个工作进程来处理队列任务。Horizon 自动使用 Supervisor 推荐的守护进程模式运行，适合生产环境。
若需重启 Horizon（例如部署更新后），可执行：
php artisan horizon:terminate
Horizon 会在下次请求时自动重启，保证平滑过渡。
访问 Horizon 仪表盘
默认情况下，Horizon 的 Web 界面位于 /horizon 路径下。只有在本地或配置允许的用户才能访问，安全性由内置中间件控制。
你可以在 app/Providers/HorizonServiceProvider.php 中修改授权逻辑，例如限制仅管理员访问：
Gate::define('viewHorizon', function ($user) {
return in_array($user->email, [
'admin@example.com'
]);
});
监控队列状态与性能指标
Horizon 仪表盘展示了丰富的实时数据：
- 当前活跃任务数：显示各队列中正在处理的任务数量
- 等待任务数：反映积压情况，有助于判断是否需要增加 worker
- 最近吞吐量：每分钟完成的任务数，用于评估系统负载能力
- 处理时间统计：最长、最短及平均执行时间
- 失败任务日志：自动记录异常任务，支持重试或删除
这些数据帮助你快速识别瓶颈，比如某个队列长时间积压可能意味着任务处理过慢或 worker 不足。
配置队列优先级与进程策略
在 config/horizon.php 中可以精细控制每个环境下的进程行为。例如：
'environments' => [
'production' => [
'supervisor-1' => [
'connection' => 'redis',
'queue' => ['high', 'default', 'low'],
'balance' => 'auto',
'processes' => 10,
'tries' => 3,
],
],
],
上述配置表示 supervisor 将从 high 队列优先取任务，使用自动负载均衡分配 10 个进程处理三个队列，每个任务最多尝试 3 次。
处理失败队列任务
当任务抛出异常且超过最大重试次数时，会被记录到失败任务列表中。你可以在 Horizon 界面的 "Failed Jobs" 标签页查看详细错误堆栈。
操作选项包括：
- 手动点击“Retry”重新推入队列
- 查看具体异常信息定位问题代码
- 永久删除不再需要处理的任务
php artisan horizon:failed-table
然后创建自定义处理器监听 JobFailed 事件。
优化建议与最佳实践
为了充分发挥 Horizon 的作用，注意以下几点：
- 定期清理已完成的日志数据，避免 Redis 内存过高
- 为关键任务设置独立队列并赋予更高优先级
- 合理设置 worker 数量，避免服务器资源耗尽
- 结合 Laravel Telescope（开发环境）与 Horizon（生产环境）全面掌握应用行为
- 使用 heartbeat 机制检测 worker 是否正常运行
基本上就这些。Laravel Horizon 让队列管理变得可视化且可控，减少运维复杂度，提升系统稳定性。只要配置得当，就能轻松应对高并发任务场景。不复杂但容易忽略细节，建议上线前充分测试队列流程。
以上就是laravel Horizon如何监控和管理队列_Laravel Horizon队列监控与管理教程的详细内容，更多请关注php中文网其它相关文章！