php怎么使用Laravel Horizon_php如何监控和管理Redis队列任务

Horizon启动后看不到队列监控页面，需手动在routes/web.php中注册Horizon::routes()并限制环境；任务卡在waiting状态多因Redis连接、队列名不匹配或Supervisor未正确配置；Redis内存暴涨应配置trim参数并定期执行horizon:clear；任务异常却显示success是因为Horizon仅判断是否执行完毕而非成功与否。 Horizon 启动后看不到队列监控页面 默认装完 并运行 ，不代表 Web 界统就自动可用。它只是启动了工作进程，Web 控制台需要额外配置路由和权限。 必须在 中手动注册 Horizon 路由： 确保该路由只在非生产环境启用，否则会暴露敏感信息；常见写法是包在 里 如果用了自定义中间件（比如强制登录），得显式允许 路由跳过或使用 中间件——默认它不带任何认证逻辑 访问路径是 ，不是 或其他变体；Nginx/Apache 若有重写规则，要确认没拦截掉这个路径 任务卡在 “waiting” 状态不执行 这通常不是 Horizon 本身的问题，而是 Redis 连接、队列配置或 Supervisor 设置没对齐。 检查 中 是否生效，且 、 可连通（用 验证） Horizon 默认监听 队列，但你的任务可能发到了 或 —— 要么改任务的 ，要么在 的 里把对应队列加进 的 数组 Supervisor 没跑？运行 ，若只有 1 个主进程没子进程，说明 supervisor 配置漏了 或没 reload：执行 Redis 内存暴涨， 不起作用 Horizon 会持续往 Redis 写入任务元数据（如 job ID、状态、执行时间），尤其在高频短任务场景下容易堆积。直接删 key 很危险，得靠配置+清理双管齐下。 PHP 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。 下载 配置控制保留多少条历史记录，默认是 ，但这个只影响 UI 展示，不删底层数据；真正释放内存靠 和 ，它们决定 Redis 中 和 的最大长度 别依赖 来清内存——它只是通知 worker 优雅退出，不清理 Redis 数据；定期执行 才会删掉过期的 completed/failed 记录 如果用的是 Redis Cluster 或哨兵模式，Horizon 不支持，会报 类错误；必须切回单机 Redis 或用 Proxy 任务抛出异常但 Horizon 显示 “success” 这是 Laravel 队列和 Horizon 状态同步的盲区：只要任务被消费并退出（哪怕 exit(1)），Horizon 就认为“执行完成”，不区分成功/失败语义。 立即学习 “ PHP免费学习笔记（深入） ”； 关键看 表或 Redis 的 —— 只有触发 方法（即任务类里定义了该方法且被调用）才算失败记录 如果你用 吞掉异常但没 re-throw，或者没调用 ，Horizon 就不会标记为 failed，只会记一条 “completed” 日志 调试时打开 ，查 里是否有 后跟异常堆栈，那是实际失败点 Horizon 的复杂点不在安装，而在它横跨了 Laravel 队列抽象、Redis 数据结构、进程管理、前端轮询四个层面。最容易被忽略的是：它不接管失败判定逻辑，也不自动清理 Redis，所有“看起来没反应”的问题，八成卡在这两个地方。