symfony messenger 命令未识别是因 messengerbundle 未启用或非全栈框架；transport 连接失败源于外部服务未运行；dispatch 后查库为空属正常异步行为；消息序列化需严格匹配构造器参数顺序或改用 public 属性。
composer require symfony/messenger 安装后命令不识别
装完 symfony/messenger，执行 php bin/console messenger:consume 报错“command not found”，不是组件没装上，而是 Symfony 的命令注册机制没触发。Messenger 组件本身不自动注册命令，得靠框架层（如 Symfony FrameworkBundle）或显式启用。
- 确认你用的是 Symfony 全栈框架（非纯组件）：只有
symfony/framework-bundle启用时，Messenger 命令才会自动加载 - 如果是 Laravel 或纯 PHP 项目，
symfony/messenger只提供核心类，messenger:consume这类命令需自己手写调度逻辑 - 检查
config/bundles.php是否包含Symfony\Bundle\MessengerBundle\MessengerBundle::class => ['all' => true]—— 缺这行，Bundle 不加载，命令自然不注册
配置 transport 时 AMQP / Redis / Doctrine 都连不上
常见现象是 Failed to connect to localhost:5672 或 Connection refused，本质不是 Messenger 配置错，而是 transport 所依赖的外部服务根本没运行或地址不对。
-
DATABASE_URL没设或指向了错误的 SQLite 文件？Doctrine transport 会静默失败，建议先用php bin/console doctrine:database:create验证连接 - AMQP（如 RabbitMQ）默认不开 5672 端口，Docker 启动要加
-p 5672:5672，且用户权限得配好（guest/guest在 3.3+ 默认禁用远程登录） - Redis transport 要求
symfony/redis-messenger包，光装symfony/messenger不够；同时REDIS_URL必须带 schema，比如redis://localhost，不能只写localhost
消息处理中 $bus->dispatch() 后立刻查数据库查不到新记录
这是异步行为的典型认知偏差：dispatch 只是把消息塞进 transport，不等 handler 执行完就返回。如果你在 dispatch 后立刻 SELECT，大概率查不到——handler 还卡在队列里没跑。
- 开发时想验证流程，别依赖“立刻查库”，改用
php bin/console messenger:consume --limit=1手动拉一条跑完再查 - 需要强一致性？别用 async transport，直接配
sync://：它绕过队列，dispatch 后同步执行 handler，适合测试或关键路径 - 注意
handle()方法里抛异常会导致消息重试（默认 3 次），不是静默吞掉——日志里搜Message will be retried就知道是不是挂了
自定义 Message 类里 __construct 参数顺序影响序列化
Messenger 序列化消息时用的是 PHP 的 serialize()（默认）或 json_encode()（配了 serializer: 'messenger.transport.symfony_serializer'），但无论哪种，都要求构造函数参数顺序和 __unserialize() / 构造器签名严格一致，否则反序列化失败报 ArgumentCountError。
- 避免在 Message 类里写带默认值的可选参数，比如
public function __construct(string $id, ?string $reason = null)—— 反序列化时$reason可能为null，但 JSON 里没这个 key，就崩 - 推荐全属性用
public，不写__construct，靠 PHP 8.2+ 的__unserialize()自动填充（Symfony 6.2+ 默认支持） - 如果必须用构造器，所有参数都设为 required，并在
__serialize()里显式返回键值对数组，比如return ['id' => $this->id, 'reason' => $this->reason];
Received message 或 Handling message，没这行，说明根本没进消费循环。
