无法向ActiveMQ Artemis发送Topic：用户验证失败问题排查

常见原因及修复方案 #

1. 误用Artemis连接工厂的配置方法 #

如果你使用的是Artemis原生JMS客户端（org.apache.activemq.artemis.jms.client.ActiveMQConnectionFactory），注意它不支持通用JMS接口的setUsername方法，必须用Artemis专属的setUser方法，或者直接在构造函数传入凭证。

错误示例：

// 无效：通用方法无法被Artemis客户端识别
ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("tcp://localhost:61616");
factory.setUsername("artemis");
factory.setPassword("artemis");

正确示例：

// 方式1：构造函数直接传入凭证
ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("tcp://localhost:61616", "artemis", "artemis");

// 方式2：使用Artemis专属的setUser方法
ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("tcp://localhost:61616");
factory.setUser("artemis");
factory.setPassword("artemis");

2. Spring Boot自动配置覆盖手动配置 #

如果项目依赖了spring-boot-starter-artemis，Spring会自动创建ConnectionFactory bean，可能会忽略你手动创建的实例。可以通过两种方式解决：

• 禁用自动配置：在启动类添加@SpringBootApplication(exclude = ArtemisAutoConfiguration.class)
• 改用配置文件让自动配置生效，在application.properties中添加：

spring.artemis.mode=native
spring.artemis.broker-url=tcp://localhost:61616
spring.artemis.user=artemis
spring.artemis.password=artemis

3. Docker容器的Artemis配置问题 #

检查Docker启动的Artemis是否正确配置了用户：

• 启动容器时要指定初始用户密码，比如：

docker run -it --rm -p 61616:61616 -e ARTEMIS_USERNAME=artemis -e ARTEMIS_PASSWORD=artemis apache/activemq-artemis:latest

• 进入容器检查etc/artemis-users.properties，确认存在artemis=artemis；同时etc/artemis-roles.properties中artemis关联了有权限的角色（比如默认的amq）。

4. 连接URL携带无效参数 #

如果连接URL中包含空的用户/密码参数（比如tcp://localhost:61616?user=&password=），会覆盖你手动设置的凭证，导致用户名被置空。确保URL中没有多余的凭证参数。

验证步骤 #

1. 调试代码，确认ConnectionFactory实例的user属性确实被设置为artemis而非null。
2. 检查Artemis容器的etc/bootstrap.xml，确认security-settings配置允许artemis用户访问目标Topic（默认配置下amq角色拥有全部权限）。
3. 用Artemis自带的命令行工具测试连接，排除代码问题：

./artemis producer --url tcp://localhost:61616 --user artemis --password artemis --destination topic://your-topic

内容的提问来源于stack exchange，提问作者Oliver Watkins