Hyperf队列消费者启动需完成配置驱动、注册启用消费者类、进程拉起三步闭环；须正确设置queue.php/amqp.php/async_queue.php，注解标识消费者并实现isEnable()，执行php bin/hyperf.php start后验证进程与任务执行。
Hyperf 的基础队列消费者启动，核心在于「配置正确 + 注册启用 + 进程拉起」三步闭环。不依赖复杂扩展，用原生 async_queue 驱动（如 Redis）或 amqp（如 RabbitMQ）均可快速跑通，关键不是选什么，而是每步是否踩准了默认约定。
确认队列驱动并完成基础配置
Hyperf 默认支持多种队列驱动，最常用的是 Redis 和 RabbitMQ。启动消费者前，必须明确你用的是哪一种，并配全连接参数：
-
Redis 队列：确保
config/autoload/queue.php中'driver' => Hyperf\AsyncQueue\Driver\RedisDriver::class已启用，且redis.pool配置指向一个可用的 Redis 连接池 -
RabbitMQ 队列：需安装
hyperf/amqp扩展，config/autoload/amqp.php必须定义default连接，且.env中补全AMQP_HOST、AMQP_PORT、AMQP_USER、AMQP_PASSWORD、AMQP_VHOST - 无论哪种驱动，
config/autoload/async_queue.php的'processes'必须设为大于 0 的整数（例如1），否则消费者进程不会被创建 —— 这是新手最常忽略的点
编写并启用消费者类
Hyperf 对消费者有明确的类注解约束，不是随便一个类就能被识别：
- 使用
async_queue时，消费者类需带#[Process]或@Process注解，并继承Hyperf\AsyncQueue\Job - 使用
amqp时，消费者类需加#[Consumer]注解（注意不是@Consumer），并继承Hyperf\Amqp\Message\ConsumerMessage - 必须实现
isEnable(): bool方法，返回true才会被加载；若返回false，该消费者将被跳过 - AMQP 消费者还需显式指定
$exchange、$routingKey、$queue属性，三者缺一不可
启动服务并验证进程状态
配置和代码就绪后，不是直接调用方法，而是靠 Hyperf 主进程拉起子工作进程：
- 执行
php bin/hyperf.php start启动服务，控制台应出现类似Process[AsyncQueueProcess] start或Process[DemoConsumer] start的日志 - 若看到
abnormal exit或进程秒退，大概率是 AMQP 连接失败（检查 host/port/vhost/权限）或 Redis 连接池未就绪 - 可运行
ps aux | grep hyperf查看实际运行的消费者进程，确认数量与async_queue.php中processes值一致 - 投递一条测试任务（如控制器中调用
$container->get(Job::class)->handle()或发送一条 AMQP 消息），观察消费者是否真正执行了handle()或consumeMessage()
常见卡点与速查建议
很多“启不来”其实卡在细节，而非框架本身：
-
环境变量未生效：确认
.env文件存在且未被 gitignore 排除，var_dump(env('AMQP_HOST'))在启动脚本里打印一下，避免配置写错位置 -
类未自动加载：新写的消费者类，记得运行
composer dump-autoload，尤其在 Docker 环境中容易因缓存导致类找不到 -
AMQP 权限问题：RabbitMQ 用户必须对指定
vhost有configure、write、read全权限，仅 administrator 角色不够 -
异步队列未开启协程：若用 Redis 驱动但
async_queue报超时，检查config/autoload/server.php中是否启用了'enable_coroutine' => true
