Spring Boot3迁移后用com.ibm.mq.jakarta.client 9.3遇MQRC_NOT_AUTHORIZED(2035)

1. 确认MQ客户端认证协议配置 #

Spring Boot 3.x基于Jakarta EE规范，IBM MQ 9.x Jakarta客户端默认认证方式可能和旧版javax客户端存在差异，建议显式开启MQCSP协议传递凭据：

• 在配置文件（application.properties/yaml）中添加：

  ibm.mq.user-authentication-mqcsp=true
  

• 或者在代码中手动设置连接工厂：

  jakarta.jms.ConnectionFactory connectionFactory = new com.ibm.mq.jakarta.jms.MQConnectionFactory();
  // 配置主机、端口、队列管理器、通道等参数
  ((MQConnectionFactory) connectionFactory).setUserAuthenticationMQCSP(true);
  

2. 核对凭据传递逻辑 #

避免依赖自动配置的隐式凭据传递，确保用户名和密码被正确传递到MQ服务器：

• 显式在连接工厂中设置用户名和密码，示例代码：

  ((MQConnectionFactory) connectionFactory).setUserName("your-mq-username");
  ((MQConnectionFactory) connectionFactory).setPassword("your-mq-password");
  

• 检查配置文件属性键是否适配Spring Boot 3.x，建议使用ibm.mq.user和ibm.mq.password替代旧版spring.jms前缀的属性。

3. 检查MQ服务器端权限配置 #

• 确认通道认证记录（CHLAUTH）规则：Jakarta客户端的连接标识可能与javax客户端存在差异，需确保CHLAUTH规则没有拒绝新的连接请求。
• 验证用户权限：使用MQ服务器命令检查目标用户是否拥有连接队列管理器、访问队列/主题的权限：

  dspmqaut -m [队列管理器名称] -t qmgr -p [用户名]
  dspmqaut -m [队列管理器名称] -t queue -n [队列名称] -p [用户名]
  

  若权限不足，使用setmqaut命令补充对应权限。

4. 清理依赖冲突 #

• 排查项目依赖树，确保没有残留的javax.jms相关依赖（如旧版com.ibm.mq.allclient、javax.jms-api），这类依赖会与Jakarta客户端产生冲突。
• 使用构建工具命令检查依赖：
  • Maven：mvn dependency:tree
  • Gradle：gradle dependencies
    发现冲突依赖后，通过<exclusions>（Maven）或exclude（Gradle）移除。

5. 启用日志定位问题 #

开启MQ客户端的DEBUG日志，获取认证过程的详细信息：

logging.level.com.ibm.mq=DEBUG
logging.level.com.ibm.mq.jakarta=DEBUG

从日志中可查看凭据传递细节、服务器端的拒绝原因，进一步定位问题根源。

内容的提问来源于stack exchange，提问作者Sugandha Mishra