Docker容器中MQ Explorer连远程队列管理器遇2538错误求助

我之前在Docker环境里用MQ Explorer连IBM MQ 8的时候，刚好碰到过一模一样的2538报错，结合你的场景给你几个针对性的排查点：

• 确认监听端口与连接配置完全匹配
  你把默认的1414改成了1417，一定要确保MQ Explorer的连接配置里填的是1417，别还留着默认值。另外在MQ Server容器里执行以下命令检查监听配置：

  runmqsc <你的队列管理器名称>
  DISPLAY LISTENER(LISTENER.TCP)
  

  要确保输出里有PORT(1417)，而且IPADDR是*（允许所有IP访问）或者MQ Explorer容器能访问的具体IP——如果是127.0.0.1的话，就算telnet能通，MQ监听也不会接受容器外的连接。

• 检查Docker端口映射是否正确
  启动MQ Server容器的时候，必须把容器内的1417端口映射到宿主机或者MQ Explorer容器能访问的端口，比如：

  docker run ... -p 1417:1417 ...
  

  我之前就犯过映射错端口的低级错误，telnet看似通了，但MQ根本收不到连接请求。

• 排查隐性的用户/安全上下文问题
  虽然你禁用了安全特性，但MQ 8的通道配置可能还是会检查用户上下文。可以尝试给服务器端的通道设置MCAUSER为管理员用户（比如mqm）：

  runmqsc <你的队列管理器名称>
  ALTER CHANNEL(<你的通道名称>) CHLTYPE(SVRCONN) MCAUSER('mqm')
  

  另外要注意，Docker里的权限是基于UID/GID的，就算你在两个容器里创建了同名用户，如果UID不一样，MQ还是会不认。可以用id mqm命令分别查看两个容器里mqm用户的ID，确保一致。

• 强制开启MQ Server的详细日志
  既然现在没有错误日志，那就手动打开 verbose 日志。在MQ Server容器里执行：

  runmqsc <你的队列管理器名称>
  ALTER QMGR LOGGING(ERROR(MAX))
  ALTER QMGR CHANNELS(CHLOUT(ENABLED))
  

  重启队列管理器后再尝试连接，然后去/var/mqm/log/<你的队列管理器名称>/目录下看AMQERR01.LOG，里面会有2538报错的具体原因——是通道不匹配、权限问题还是网络问题一目了然。

• 确认MQ Explorer与Server的版本兼容性
  你用的是IBM官方的MQ Explorer容器，要确保它的版本和MQ Server 8完全兼容。高版本Explorer连低版本Server或者反过来，都可能出现莫名其妙的连接失败，尽量用对应MQ 8版本的Explorer。

我当时的问题就是Docker端口映射打错了，把1416映射到了容器内的1417，开启详细日志后一眼就看到了问题所在。

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