消息队列 / 系统课时
消息属性可以携带哪些信息
消息属性可以携带哪些信息
消息体只是一串字节,消费者无法仅凭字节稳定判断格式、身份或上下文。RabbitMQ 的消息属性为正文之外的元数据提供标准位置,例如 contentType、messageId、correlationId 和 headers,便于服务之间建立清晰约定。
学习目标
- 区分消息体与消息属性各自承担的职责
- 理解常用属性的语义以及适合存放的信息
- 在 Java 客户端中设置属性,并在消费端读取验证
属性和消息体怎样分工
消息体应该承载业务数据,例如订单 JSON;消息属性描述“这段数据是什么、如何关联、如何处理”。RabbitMQ Java Client 使用 AMQP.BasicProperties 表示这些元数据,并提供 AMQP.BasicProperties.Builder 构造属性对象。([RabbitMQ][3])
属性不是业务正文的替代品。把完整订单对象塞进 headers 会让协议边界变得混乱,也增加消息头开销;更合适的做法是让正文承载主要业务数据,让属性保存跨服务都需要识别的小型元数据。
常用属性分别解决什么问题
| 属性 | 常见用途 | 典型值 |
|---|---|---|
contentType |
声明消息体媒体类型 | application/json |
contentEncoding |
声明正文字符编码 | UTF-8 |
messageId |
标识一条消息,便于追踪或去重设计 | msg-1001 |
correlationId |
关联请求与响应,或串联同一业务链路 | req-42 |
type |
描述消息的业务类型 | order.created |
headers |
携带少量自定义键值元数据 | tenant-id=tenant-a |
replyTo |
指定响应应发送到哪里,常见于 RPC | 回调队列名 |
deliveryMode |
2 表示持久消息意图 |
2 |
deliveryMode=2 只是可靠性设计的一部分,不能单独保证消息经历 Broker 重启后仍然存在;队列类型、队列持久性以及发布确认等配置仍需一起考虑。correlationId 则常用于 RPC 请求与响应配对。([RabbitMQ][4])
发布时设置属性,消费时读取
下面示例使用默认交换机把消息发送到一个临时队列,重点只观察属性是否随消息一起到达。项目需要先引入 RabbitMQ Java Client,并确保本机 RabbitMQ 可以通过默认连接参数访问。
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.GetResponse;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
public class MessagePropertiesDemo {
public static void main(String[] args) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
String queue = channel.queueDeclare().getQueue();
Map<String, Object> headers = new HashMap<>();
headers.put("tenant-id", "tenant-a");
headers.put("schema-version", 1);
AMQP.BasicProperties properties =
new AMQP.BasicProperties.Builder()
.contentType("application/json")
.contentEncoding("UTF-8")
.messageId("msg-1001")
.correlationId("req-42")
.type("order.created")
.headers(headers)
.build();
String body = "{\"orderId\":1001}";
channel.basicPublish(
"",
queue,
properties,
body.getBytes(StandardCharsets.UTF_8));
GetResponse response = channel.basicGet(queue, true);
if (response == null) {
throw new IllegalStateException("队列中没有消息");
}
AMQP.BasicProperties received = response.getProps();
System.out.println("contentType=" + received.getContentType());
System.out.println("messageId=" + received.getMessageId());
System.out.println("correlationId=" + received.getCorrelationId());
System.out.println("tenantId="
+ received.getHeaders().get("tenant-id"));
}
}
}预期输出
contentType=application/json
messageId=msg-1001
correlationId=req-42
tenantId=tenant-a这个结果说明属性和消息体一起被传递,但两者在 API 中仍然是分开的:正文通过 getBody() 读取,属性通过 getProps() 读取。
设计属性时避免几个常见误区
contentType 是生产者与消费者之间的格式约定,不会让 RabbitMQ 自动把 JSON 反序列化成对象。messageId 也不会自动提供幂等能力,消费者若要据此去重,仍需自己保存和检查已处理标识。
headers 适合租户标识、追踪信息、版本号等短小元数据,但值必须能映射到 AMQP field table 支持的类型。需要路由时,也不要默认认为所有交换机都会读取 headers;是否参与路由由交换机类型和 Binding 规则决定。
好的消息属性应该稳定、可解释,并且不与消息体重复保存同一份业务内容。这样消费者既能快速判断消息上下文,也能在不解析正文的情况下完成追踪、关联和协议选择。