前端首页不能直接调用队列任务状态，因队列消费者与HTTP请求生命周期完全隔离，无共享内存和实时状态接口；应通过数据库记录task_id状态并轮询查询，而非依赖Redis长度或进程检查。
前端首页不能直接调用队列任务状态——这不是权限或接口问题，而是架构层面的隔离原则。队列消费者进程运行在命令行环境，与 HTTP 请求生命周期完全分离，没有共享内存、不暴露原生状态接口，强行“调用”只会得到过期、不准或报错的结果。
为什么不能在控制器里查 queue:status 这类命令
ThinkPHP 没有内置 queue:status 命令，也不存在能实时返回“当前处理到第几个任务”的 API。所谓“状态”，其实是多个维度的拼凑结果：Redis 里待消费数量、Supervisor 进程存活情况、failed_jobs 表失败计数、日志里最近一次成功时间。它们分散在不同地方，且无统一时钟同步。
-
php think queue:work是阻塞式常驻进程，不提供 HTTP 接口，也不响应外部查询 - 你在控制器里执行
shell_exec('redis-cli llen default')看到的只是那一刻的队列长度，不是“是否正在消费” - 若用
ps aux | grep queue:work，会因 PHP-FPM 权限限制失败，或返回空结果（web 用户无法读取 supervisor 管理的进程）
真正可落地的前端状态展示方案
前端要显示的不是“技术状态”，而是用户关心的业务信号：任务是否已触发？有没有卡住？失败后能否重试？这些必须靠“间接指标 + 后端打点”实现。
- 任务推送时记录唯一
$task_id，存入数据库字段如queue_task_log表，含status（pending/running/success/failed）、created_at、updated_at - 在
fire()方法开头写Db::name('queue_task_log')->where('id', $data['task_id'])->update(['status' => 'running']) - 成功后更新为
success，失败进failed()方法时更新为failed并记录错误信息 - 前端轮询
/api/queue/task-status?task_id=xxx，只查这张表，不碰 Redis 或进程
Redis 队列长度只能作参考，别当真
用 llen default 查到数字是 0，不代表没任务——可能消费者刚启动还没拉取；查到是 1000，也不代表积压严重——如果单任务耗时 200ms，1000 个也只要 3 分半跑完。关键要看 retry_after 和实际执行日志的时间差。
立即学习“PHP免费学习笔记（深入）”；
- 确保
config/queue.php中connections.redis.retry_after大于最长任务耗时（比如设成 600，而不是默认 60） - 检查
runtime/log/queue/下日志，搜索"Job failed"或"Processed job"的时间戳间隔 - 若发现大量任务在
retry_after时间后被重复取出，说明要么超时设置太短，要么某类任务真卡死了
最易被忽略的一点：前端轮询接口本身要加缓存头（Cache-Control: no-cache），但不要用 ETag 或 Last-Modified 做服务端校验——因为状态变更不触发资源更新，纯靠数据库字段驱动，否则你会看到“明明改了 status 却还是返回旧值”的现象。
