如何在Symfony中配置消息队列与RabbitMQ-php教程-PHP中文网

old_sound_rabbit_mq bundle是symfony 4.4–6.x对接rabbitmq最成熟可控方式；需在bundles.php中显式启用，配置须设lazy: false、connection_timeout: 5、read_write_timeout: 10，并用单引号包裹vhost。

如何在symfony中配置消息队列与rabbitmq

直接用 old_sound_rabbit_mq Bundle 是当前 Symfony 项目（4.4–6.x）对接 RabbitMQ 最成熟、最可控的方式。Symfony Messenger 虽然更“现代”，但对 RabbitMQ 的底层控制弱、调试信息少，生产环境出问题时排查成本高。

安装与 Bundle 注册必须同步做

只运行 composer require oldsound/rabbitmq-bundle 不够，你还得显式启用它：

config/bundles.php 中必须有 OldSound\RabbitMqBundle\OldSoundRabbitMqBundle::class => ['all' => true]
如果项目是 Symfony 7+，注意该 Bundle 官方尚未正式支持 Symfony 7，lazy: true 可能触发服务未初始化错误，建议先降级到 6.4 LTS 或改用 Messenger + symfony/amqp-messenger
不要混用 php-amqplib/rabbitmq-bundle 和 oldsound/rabbitmq-bundle —— 后者才是维护活跃的主分支，前者已归档

连接配置里最容易漏掉的三个关键项

光填 host、port、user、password 会在线上环境频繁断连或超时：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

lazy: false：设为 false 才会在容器启动时立即建连，否则首次 publish 时才尝试连接，失败就抛异常
connection_timeout: 5 和 read_write_timeout: 10：默认都是 3 秒，内网 OK，跨可用区或 TLS 链路下极易触发 AMQPConnectionException
vhost: '/' 必须用单引号包裹，否则 YAML 解析器可能把它当注释处理；若 RabbitMQ 实际 vhost 名含下划线（如 app_prod），也务必加引号

生产者配置中 exchange_options 和 queue_options 的区别

很多人误以为两者可互换，其实它们作用阶段完全不同：

exchange_options 控制消息“怎么发出去”：决定 exchange 名、类型（direct / topic / fanout）、是否 durable: true（重启后 exchange 是否保留）
queue_options 只在消费者配置里生效，定义队列本身属性；生产者配置里的 queue_options 实际被忽略 —— 这是 Bundle 的设计限制，不是你配错了
如果你用 type: topic，必须确保 routing key 格式合法（如 order.created.us），否则消息会被静默丢弃，日志里只显示 NO_ROUTE

消费者类 callback 必须是服务 ID，不是类名

配置里写 callback: App\Consumer\OrderConsumer 是错的，会报 Service "App\Consumer\OrderConsumer" not found：

callback 值必须是容器中已注册的服务 ID，比如 callback: app.consumer.order

对应的服务需在 config/services.yaml 中显式声明：

app.consumer.order:
    class: App\Consumer\OrderConsumer
    arguments: ['@logger']

该类必须实现 OldSound\RabbitMqBundle\RabbitMq\ConsumerInterface，且 execute 方法返回 ConsumerInterface::MSG_ACK、MSG_REJECT 或 MSG_REQUEUE —— 返回 true 或 void 会导致消息无限重试