发送和接收一条消息

认识生产者、队列和消费者,用两个程序完成一次消息收发。

🎯 引言

认识生产者、队列和消费者,用两个程序完成一次消息收发。


🧱 三个角色分别做什么

发送消息的程序叫生产者,接收并处理消息的程序叫消费者,消息等待处理的位置叫队列。队列在 RabbitMQ 服务端,不在发送程序的内存里。

本篇先传一段表示支付成功的文字,观察完整过程。暂不扩展多个业务系统。

正在加载流程图…

这是简化图。客户端提供的 sendToQueue() 实际经过 RabbitMQ 内置的默认交换机转发到同名队列;交换机是消息转发入口,下一阶段再配置它。


📤 编写发送程序

沿用环境篇的配置。连接建立后,用 createChannel() 创建通道,即这条连接上执行消息操作的逻辑会话。我们通过通道创建队列、发送或接收消息。

send.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();

await channel.assertQueue('payment', { durable: false });
channel.sendToQueue('payment', Buffer.from('payment succeeded'));
console.log('已提交消息');
await channel.close();
await connection.close();

payment 表示支付通知队列,名称由应用约定,RabbitMQ 不会根据名字自动决定消息去向。assertQueue() 确保这个队列存在;同名且配置相同时,可以重复调用。durable: false 表示本篇不要求重启服务后保留队列。

sendToQueue() 的参数是队列名和正文。正文需要字节数据,所以使用 Buffer.from() 转换文字。发送后关闭通道和连接,让程序正常退出;打印“已提交”不代表接收方已处理成功。


📥 编写接收程序

receive.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const connection = await amqp.connect(rabbitmqUrl);
const channel = await connection.createChannel();

await channel.assertQueue('payment', { durable: false });
await channel.consume('payment', (message) => {
    if (message === null) return;
    console.log('收到:', message.content.toString());
}, { noAck: true });
console.log('等待消息,按 Ctrl+C 停止');

consume() 订阅队列,消息到达时执行回调。message.content 是收到的字节数据,toString() 把它还原为文字。收到 null 表示服务端取消了订阅,不是普通消息。

noAck: true 表示不等待消费者主动确认。这个基础示例只打印文字;如果程序收到后崩溃,RabbitMQ 不会因此重发。可靠性章节再改为处理完成后确认。


🧪 在两个终端观察结果

先在终端一发送:

node send.mjs

终端二再启动接收:

node receive.mjs

应看到 收到: payment succeeded。发送方早已退出,消息仍能被收到,说明消息保存在服务端队列中。再运行发送脚本,接收终端会新增一条输出。接收程序持续等待,按 Ctrl+C 停止。


❓ 知识问答

Q1:同名队列每次声明都会清空吗?

不会,配置一致时复用原队列。配置不同可能报错,不要靠改名以外的隐式行为覆盖旧配置。

Q2:两个接收程序订阅同一队列会各收到一份吗?

不会,它们分担消息。多系统各收到一份需要独立队列,下一阶段会演示。

Q3:消息可以先于队列发送吗?

本例先声明队列再发送。队列不存在时,消息没有这个接收位置,新建队列不会补回历史消息。


🧪 小练习

停止接收程序,连续发送两次后再启动它。预期新增两条输出;完成后停止接收程序,避免后续混淆。


🎉 你已经跑通消息从生产者到消费者的过程了!