消息正文与属性

把文字消息换成 JSON,并区分业务字段与 RabbitMQ 消息属性。

🎯 引言

把文字消息换成 JSON,并区分业务字段与 RabbitMQ 消息属性。


🧱 为什么要约定消息格式

只有“支付成功”四个字,接收系统不知道对应哪个订单。因此消息正文需要包含接收方完成操作所需的数据。

正文是实际传递的数据;属性是正文外的说明,例如内容格式 contentType 和消息标识 messageId。RabbitMQ 传递这些信息,但不检查支付是否真实,也不会自动校验 JSON 字段。

本篇约定 paymentId 表示支付编号,orderId 表示订单编号,amountFen 表示以分为单位的整数金额。这些是业务字段,不是 RabbitMQ 固定要求。


📤 编码与发送

使用新队列 receipt,避免与上一节文字消息混在一起:

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

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

await channel.assertQueue('receipt', { durable: false });
const event = { paymentId: 'P1001', orderId: 'O1001', amountFen: 9900 };
channel.sendToQueue('receipt', Buffer.from(JSON.stringify(event)), {
    contentType: 'application/json',
    messageId: 'evt-P1001',
});
console.log('已提交 evt-P1001');
await channel.close();
await connection.close();

先把对象编码成 JSON 文字,再转换为字节。contentType 标记格式,不会自动完成这个转换;messageId 帮助接收方关联日志,也不会自动去重。


📥 读取正文与属性

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

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

await channel.assertQueue('receipt', { durable: false });
await channel.consume('receipt', (message) => {
    if (message === null) return;
    const event = JSON.parse(message.content.toString());
    console.log(message.properties.messageId, event.orderId, event.amountFen);
}, { noAck: true });
console.log('等待 JSON 消息');

正文通过 message.content 读取,属性通过 message.properties 读取。先启动接收脚本,再在另一终端发送:

node receive-json.mjs
node send-json.mjs

接收终端输出 evt-P1001 O1001 9900。本篇只接收自己发送的合法 JSON,实际消费者还要检查字段类型和必要值;格式错误的消息如何拒绝,放在失败处理阶段学习。


🧰 格式变化要兼容已有消息

队列可能还保存着旧消息,消费者也不一定同时更新。增加可选字段时,接收方允许它缺失;更名或删除必需字段前,先安排消费者兼容。不要把一个字段改名当成 RabbitMQ 会自动处理的转换。


❓ 知识问答

Q1:能直接把对象传给 sendToQueue 吗?

不能,这个客户端方法要求正文是 Buffer,需要先编码。

Q2:正文必须是 JSON 吗?

不必须。发送方与接收方约定一致的编码即可,本课程选择 JSON 便于阅读。

Q3:不同消息使用相同 messageId 会被丢弃吗?

不会,本课程使用的普通队列不会据此去重。避免重复业务需要消费者配合。


🧪 小练习

增加可选字段 paidAt 并打印它,然后发送不带这个字段的旧格式消息。两种消息都应能被接收。


🎉 你已经能读懂消息正文和附加属性了!