1. 消息队列技术概述消息队列Message Queue作为分布式系统中的关键组件已经存在了三十余年。我第一次接触这个概念是在2010年处理一个电商订单系统时当时系统在促销期间频繁崩溃后来引入消息队列才解决了问题。简单来说消息队列就像现实生活中的邮局发送方把消息投递到队列中接收方按照自己的处理能力从队列中取消息双方不需要同时在线也不需要知道对方的具体位置。JMSJava Message Service是Java平台上关于消息队列的API规范类似于JDBC对于数据库的作用。它定义了一套通用接口让开发者可以用统一的方式操作不同的消息队列实现。ActiveMQ则是JMS规范的一个开源实现由Apache基金会维护目前最新稳定版本是5.16.x系列。2. JMS核心概念解析2.1 消息模型JMS支持两种基本消息模型点对点Queue每条消息只有一个消费者典型场景如订单处理发布/订阅Topic消息广播给所有订阅者适合事件通知系统我在实际项目中发现很多初学者容易混淆这两种模型。一个简单的记忆方法是Queue就像公司内部的任务分配系统一个任务只会分配给一个人Topic则像公司公告栏所有人都能看到通知。2.2 消息组成一个标准的JMS消息包含三部分消息头Headers包含JMS定义的元数据如JMSDestination消息目的地JMSDeliveryMode持久化/非持久化JMSPriority优先级(0-9)消息属性Properties开发者自定义的键值对消息体BodyJMS定义了5种消息类型TextMessage最常用的文本消息MapMessage键值对集合BytesMessage二进制数据StreamMessageJava原始值流ObjectMessage序列化的Java对象重要提示ObjectMessage由于存在反序列化漏洞风险在生产环境中应谨慎使用。我们团队现在基本都用JSON格式的TextMessage替代。3. ActiveMQ实战配置3.1 环境搭建以Linux系统为例安装ActiveMQ 5.16.3wget https://archive.apache.org/dist/activemq/5.16.3/apache-activemq-5.16.3-bin.tar.gz tar -xzf apache-activemq-5.16.3-bin.tar.gz cd apache-activemq-5.16.3/bin ./activemq start启动后可以通过http://localhost:8161/admin访问管理控制台默认账号密码都是admin。强烈建议首次登录后立即修改密码。3.2 核心配置文件解析ActiveMQ的主配置文件是conf/activemq.xml几个关键配置项broker xmlnshttp://activemq.apache.org/schema/core brokerNamelocalhost dataDirectory${activemq.data} persistenceAdapter kahaDB directory${activemq.data}/kahadb/ /persistenceAdapter systemUsage systemUsage memoryUsage limit64 mb/ storeUsage limit100 gb/ tempUsage limit50 gb/ /systemUsage /systemUsage transportConnectors transportConnector nameopenwire uritcp://0.0.0.0:61616/ /transportConnectors /broker配置项说明生产环境建议persistenceAdapter消息存储方式高吞吐场景可考虑LevelDBmemoryUsage内存限制根据服务器内存调整storeUsage磁盘存储限制设为磁盘空间的70-80%transportConnectors网络协议和端口建议配置SSL加密3.3 集群配置ActiveMQ支持多种集群方式最常用的是Network of Brokers。在activemq.xml中添加networkConnectors networkConnector namebridge uristatic:(tcp://otherhost:61616) duplextrue conduitSubscriptionstrue decreaseNetworkConsumerPrioritytrue/ /networkConnectors集群配置中有几个容易踩坑的参数duplex是否双向通信默认为falsedynamicOnly是否只动态发现新加入的brokerprefetchSize消费者预取数量设置不当会导致消息堆积4. Java客户端开发实战4.1 基础生产者示例public class SimpleProducer { public static void main(String[] args) throws JMSException { ConnectionFactory factory new ActiveMQConnectionFactory(tcp://localhost:61616); Connection connection factory.createConnection(); connection.start(); Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination queue session.createQueue(TEST.QUEUE); MessageProducer producer session.createProducer(queue); producer.setDeliveryMode(DeliveryMode.PERSISTENT); // 持久化消息 TextMessage message session.createTextMessage(Hello ActiveMQ!); producer.send(message); connection.close(); } }4.2 事务与确认模式JMS Session的创建方式直接影响消息可靠性// 非事务会话自动确认 Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); // 非事务会话客户端确认 Session session connection.createSession(false, Session.CLIENT_ACKNOWLEDGE); // 事务会话 Session session connection.createSession(true, Session.SESSION_TRANSACTED);经验之谈电商订单类关键业务一定要用事务会话日志类非关键业务可以用自动确认提升性能。4.3 消费者最佳实践public class AsyncConsumer implements MessageListener { public static void main(String[] args) throws Exception { ConnectionFactory factory new ActiveMQConnectionFactory(tcp://localhost:61616); Connection connection factory.createConnection(); connection.start(); Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination queue session.createQueue(TEST.QUEUE); MessageConsumer consumer session.createConsumer(queue); consumer.setMessageListener(new AsyncConsumer()); } Override public void onMessage(Message message) { try { TextMessage textMessage (TextMessage) message; System.out.println(Received: textMessage.getText()); } catch (JMSException e) { e.printStackTrace(); } } }消费者端的几个优化点合理设置prefetchSize默认为1000使用异步监听器而非同步receive()处理消息时捕获所有异常考虑使用消息组Message Groups保证顺序性5. 性能调优与监控5.1 关键性能指标指标健康值监控方式内存使用率70%JMX或管理控制台存储使用率80%同上消息积压数持续增长需预警监控队列Size消费者数量与队列数匹配确保没有为0的情况5.2 调优参数在activemq.xml中调整systemUsage systemUsage memoryUsage limit512 mb/ storeUsage limit50 gb/ tempUsage limit10 gb/ /systemUsage /systemUsage policyEntry queue producerFlowControlfalse memoryLimit32mb pendingQueuePolicy vmQueueCursor/ /pendingQueuePolicy /policyEntry5.3 常见问题排查消息堆积检查消费者是否正常运行调整prefetchSize增加消费者实例生产者阻塞关闭producerFlowControl使用异步发送((ActiveMQConnectionFactory)factory).setUseAsyncSend(true);内存溢出限制memoryUsage监控消息积压使用VM cursor6. 安全配置建议6.1 认证配置在conf/credentials.properties中activemq.usernamesystem activemq.passwordmanager guest.passwordpassword在conf/jetty-realm.properties中配置web控制台权限。6.2 传输加密配置SSL连接sslContext sslContext keyStorefile:${activemq.conf}/broker.ks keyStorePasswordpassword trustStorefile:${activemq.conf}/broker.ts trustStorePasswordpassword/ /sslContext transportConnectors transportConnector namessl urissl://0.0.0.0:61617/ /transportConnectors6.3 最佳安全实践禁止使用默认密码控制台只允许内网访问定期轮换SSL证书启用消息加密如使用Jasypt7. 与Spring集成7.1 基础配置bean idconnectionFactory classorg.apache.activemq.ActiveMQConnectionFactory property namebrokerURL valuetcp://localhost:61616/ /bean bean idjmsTemplate classorg.springframework.jms.core.JmsTemplate property nameconnectionFactory refconnectionFactory/ property namedefaultDestinationName valueTEST.QUEUE/ /bean7.2 注解驱动监听JmsListener(destination TEST.QUEUE) public void processMessage(String content) { System.out.println(Received: content); }7.3 事务管理Bean public JmsTransactionManager jmsTransactionManager(ConnectionFactory cf) { return new JmsTransactionManager(cf); } Transactional public void processOrder(Order order) { jmsTemplate.convertAndSend(ORDERS.QUEUE, order); // 其他数据库操作 }8. 高可用方案8.1 Master-Slave部署共享存储方案如SAN或NASactivemq.xml配置 persistenceAdapter kahaDB directory/shared/activemq-data/kahadb/ /persistenceAdapter8.2 客户端故障转移连接URL配置多个brokerfailover:(tcp://primary:61616,tcp://secondary:61616)?randomizefalse参数说明initialReconnectDelay首次重连延迟(ms)maxReconnectDelay最大重连延迟(ms)useExponentialBackOff是否启用指数退避8.3 网络分区处理配置networkConnector的duplextrue可以避免脑裂问题同时建议设置networkConnector uristatic:(tcp://backup:61616) dynamicOnlytrue networkTTL3 duplextrue/9. 与Kafka对比选型特性ActiveMQKafka设计目标企业集成流处理协议支持JMS, AMQP等自有协议消息模型Queue/TopicTopic/Partition吞吐量万级百万级延迟毫秒级毫秒~秒级持久化可选强制顺序保证有限支持分区内严格有序选型建议需要严格JMS兼容 → ActiveMQ超高吞吐量场景 → Kafka复杂路由需求 → ActiveMQ流处理需求 → Kafka10. 真实案例分享去年我们为一家物流公司设计的系统架构中ActiveMQ承担了核心作用订单接入层使用Queue处理订单创建调度中心使用Topic广播车辆位置更新异常处理DLQ(Dead Letter Queue)捕获处理失败消息关键配置destinationPolicy policyMap policyEntries policyEntry queue deadLetterStrategy individualDeadLetterStrategy queuePrefixDLQ. useQueueForQueueMessagestrue/ /deadLetterStrategy /policyEntry /policyEntries /policyMap /destinationPolicy遇到的坑最初没限制内存使用导致OOM网络闪断导致消息重复消费者处理慢引发堆积解决方案设置合理的memoryLimit启用幂等消费动态扩容消费者 
长河君 · 2026/11/4 10:22:50 · 阅读 1.2k ActiveMQ消息队列核心原理与实战配置指南
1. 消息队列技术概述消息队列Message Queue作为分布式系统中的关键组件已经存在了三十余年。我第一次接触这个概念是在2010年处理一个电商订单系统时当时系统在促销期间频繁崩溃后来引入消息队列才解决了问题。简单来说消息队列就像现实生活中的邮局发送方把消息投递到队列中接收方按照自己的处理能力从队列中取消息双方不需要同时在线也不需要知道对方的具体位置。JMSJava Message Service是Java平台上关于消息队列的API规范类似于JDBC对于数据库的作用。它定义了一套通用接口让开发者可以用统一的方式操作不同的消息队列实现。ActiveMQ则是JMS规范的一个开源实现由Apache基金会维护目前最新稳定版本是5.16.x系列。2. JMS核心概念解析2.1 消息模型JMS支持两种基本消息模型点对点Queue每条消息只有一个消费者典型场景如订单处理发布/订阅Topic消息广播给所有订阅者适合事件通知系统我在实际项目中发现很多初学者容易混淆这两种模型。一个简单的记忆方法是Queue就像公司内部的任务分配系统一个任务只会分配给一个人Topic则像公司公告栏所有人都能看到通知。2.2 消息组成一个标准的JMS消息包含三部分消息头Headers包含JMS定义的元数据如JMSDestination消息目的地JMSDeliveryMode持久化/非持久化JMSPriority优先级(0-9)消息属性Properties开发者自定义的键值对消息体BodyJMS定义了5种消息类型TextMessage最常用的文本消息MapMessage键值对集合BytesMessage二进制数据StreamMessageJava原始值流ObjectMessage序列化的Java对象重要提示ObjectMessage由于存在反序列化漏洞风险在生产环境中应谨慎使用。我们团队现在基本都用JSON格式的TextMessage替代。3. ActiveMQ实战配置3.1 环境搭建以Linux系统为例安装ActiveMQ 5.16.3wget https://archive.apache.org/dist/activemq/5.16.3/apache-activemq-5.16.3-bin.tar.gz tar -xzf apache-activemq-5.16.3-bin.tar.gz cd apache-activemq-5.16.3/bin ./activemq start启动后可以通过http://localhost:8161/admin访问管理控制台默认账号密码都是admin。强烈建议首次登录后立即修改密码。3.2 核心配置文件解析ActiveMQ的主配置文件是conf/activemq.xml几个关键配置项broker xmlnshttp://activemq.apache.org/schema/core brokerNamelocalhost dataDirectory${activemq.data} persistenceAdapter kahaDB directory${activemq.data}/kahadb/ /persistenceAdapter systemUsage systemUsage memoryUsage limit64 mb/ storeUsage limit100 gb/ tempUsage limit50 gb/ /systemUsage /systemUsage transportConnectors transportConnector nameopenwire uritcp://0.0.0.0:61616/ /transportConnectors /broker配置项说明生产环境建议persistenceAdapter消息存储方式高吞吐场景可考虑LevelDBmemoryUsage内存限制根据服务器内存调整storeUsage磁盘存储限制设为磁盘空间的70-80%transportConnectors网络协议和端口建议配置SSL加密3.3 集群配置ActiveMQ支持多种集群方式最常用的是Network of Brokers。在activemq.xml中添加networkConnectors networkConnector namebridge uristatic:(tcp://otherhost:61616) duplextrue conduitSubscriptionstrue decreaseNetworkConsumerPrioritytrue/ /networkConnectors集群配置中有几个容易踩坑的参数duplex是否双向通信默认为falsedynamicOnly是否只动态发现新加入的brokerprefetchSize消费者预取数量设置不当会导致消息堆积4. Java客户端开发实战4.1 基础生产者示例public class SimpleProducer { public static void main(String[] args) throws JMSException { ConnectionFactory factory new ActiveMQConnectionFactory(tcp://localhost:61616); Connection connection factory.createConnection(); connection.start(); Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination queue session.createQueue(TEST.QUEUE); MessageProducer producer session.createProducer(queue); producer.setDeliveryMode(DeliveryMode.PERSISTENT); // 持久化消息 TextMessage message session.createTextMessage(Hello ActiveMQ!); producer.send(message); connection.close(); } }4.2 事务与确认模式JMS Session的创建方式直接影响消息可靠性// 非事务会话自动确认 Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); // 非事务会话客户端确认 Session session connection.createSession(false, Session.CLIENT_ACKNOWLEDGE); // 事务会话 Session session connection.createSession(true, Session.SESSION_TRANSACTED);经验之谈电商订单类关键业务一定要用事务会话日志类非关键业务可以用自动确认提升性能。4.3 消费者最佳实践public class AsyncConsumer implements MessageListener { public static void main(String[] args) throws Exception { ConnectionFactory factory new ActiveMQConnectionFactory(tcp://localhost:61616); Connection connection factory.createConnection(); connection.start(); Session session connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination queue session.createQueue(TEST.QUEUE); MessageConsumer consumer session.createConsumer(queue); consumer.setMessageListener(new AsyncConsumer()); } Override public void onMessage(Message message) { try { TextMessage textMessage (TextMessage) message; System.out.println(Received: textMessage.getText()); } catch (JMSException e) { e.printStackTrace(); } } }消费者端的几个优化点合理设置prefetchSize默认为1000使用异步监听器而非同步receive()处理消息时捕获所有异常考虑使用消息组Message Groups保证顺序性5. 性能调优与监控5.1 关键性能指标指标健康值监控方式内存使用率70%JMX或管理控制台存储使用率80%同上消息积压数持续增长需预警监控队列Size消费者数量与队列数匹配确保没有为0的情况5.2 调优参数在activemq.xml中调整systemUsage systemUsage memoryUsage limit512 mb/ storeUsage limit50 gb/ tempUsage limit10 gb/ /systemUsage /systemUsage policyEntry queue producerFlowControlfalse memoryLimit32mb pendingQueuePolicy vmQueueCursor/ /pendingQueuePolicy /policyEntry5.3 常见问题排查消息堆积检查消费者是否正常运行调整prefetchSize增加消费者实例生产者阻塞关闭producerFlowControl使用异步发送((ActiveMQConnectionFactory)factory).setUseAsyncSend(true);内存溢出限制memoryUsage监控消息积压使用VM cursor6. 安全配置建议6.1 认证配置在conf/credentials.properties中activemq.usernamesystem activemq.passwordmanager guest.passwordpassword在conf/jetty-realm.properties中配置web控制台权限。6.2 传输加密配置SSL连接sslContext sslContext keyStorefile:${activemq.conf}/broker.ks keyStorePasswordpassword trustStorefile:${activemq.conf}/broker.ts trustStorePasswordpassword/ /sslContext transportConnectors transportConnector namessl urissl://0.0.0.0:61617/ /transportConnectors6.3 最佳安全实践禁止使用默认密码控制台只允许内网访问定期轮换SSL证书启用消息加密如使用Jasypt7. 与Spring集成7.1 基础配置bean idconnectionFactory classorg.apache.activemq.ActiveMQConnectionFactory property namebrokerURL valuetcp://localhost:61616/ /bean bean idjmsTemplate classorg.springframework.jms.core.JmsTemplate property nameconnectionFactory refconnectionFactory/ property namedefaultDestinationName valueTEST.QUEUE/ /bean7.2 注解驱动监听JmsListener(destination TEST.QUEUE) public void processMessage(String content) { System.out.println(Received: content); }7.3 事务管理Bean public JmsTransactionManager jmsTransactionManager(ConnectionFactory cf) { return new JmsTransactionManager(cf); } Transactional public void processOrder(Order order) { jmsTemplate.convertAndSend(ORDERS.QUEUE, order); // 其他数据库操作 }8. 高可用方案8.1 Master-Slave部署共享存储方案如SAN或NASactivemq.xml配置 persistenceAdapter kahaDB directory/shared/activemq-data/kahadb/ /persistenceAdapter8.2 客户端故障转移连接URL配置多个brokerfailover:(tcp://primary:61616,tcp://secondary:61616)?randomizefalse参数说明initialReconnectDelay首次重连延迟(ms)maxReconnectDelay最大重连延迟(ms)useExponentialBackOff是否启用指数退避8.3 网络分区处理配置networkConnector的duplextrue可以避免脑裂问题同时建议设置networkConnector uristatic:(tcp://backup:61616) dynamicOnlytrue networkTTL3 duplextrue/9. 与Kafka对比选型特性ActiveMQKafka设计目标企业集成流处理协议支持JMS, AMQP等自有协议消息模型Queue/TopicTopic/Partition吞吐量万级百万级延迟毫秒级毫秒~秒级持久化可选强制顺序保证有限支持分区内严格有序选型建议需要严格JMS兼容 → ActiveMQ超高吞吐量场景 → Kafka复杂路由需求 → ActiveMQ流处理需求 → Kafka10. 真实案例分享去年我们为一家物流公司设计的系统架构中ActiveMQ承担了核心作用订单接入层使用Queue处理订单创建调度中心使用Topic广播车辆位置更新异常处理DLQ(Dead Letter Queue)捕获处理失败消息关键配置destinationPolicy policyMap policyEntries policyEntry queue deadLetterStrategy individualDeadLetterStrategy queuePrefixDLQ. useQueueForQueueMessagestrue/ /deadLetterStrategy /policyEntry /policyEntries /policyMap /destinationPolicy遇到的坑最初没限制内存使用导致OOM网络闪断导致消息重复消费者处理慢引发堆积解决方案设置合理的memoryLimit启用幂等消费动态扩容消费者