Golang应用连接IBM MQ报错：用户名过长（超13字符）求助

问题根源 #

IBM MQ MacOS客户端会自动读取当前系统用户名用于内部标识，当用户名长度超过13字符时触发xcsGetpwuid got password entry with user name too long (more than 13 characters)错误——即便连接无需用户名/密码验证，这个内部检查依然会执行。

绕过方法 #

• 临时通过环境变量覆盖
  在启动Golang应用前，临时设置USER环境变量为任意13字符以内的名称（无需是系统已存在的用户）：

  USER=mqshort go run your-app.go
  

  该设置仅对当前终端会话内的应用生效。

• 在代码中显式指定用户标识
  使用MQ Golang SDK时，在连接配置里强制设置UserIdentifier字段，直接覆盖系统自动获取的用户名：

  import "github.com/ibm-messaging/mq-golang/v5/ibmmq"
  
  func main() {
      // 初始化连接配置
      cno := ibmmq.NewMQCNO()
      cd := ibmmq.NewMQCD()
      // 配置队列管理器、通道等核心信息...
      cno.ClientConn = cd
  
      // 关键：设置13字符以内的用户标识
      cno.UserIdentifier = []byte("mquser123")
  
      // 建立连接
      qMgr, err := ibmmq.Conn("QMGR_NAME", cno)
      if err != nil {
          // 错误处理逻辑
      }
      defer qMgr.Disc()
  
      // 后续业务代码...
  }
  

• 修改MQ客户端全局配置
  在用户目录下创建或修改.mqclient.ini文件（无则新建），添加以下配置实现全局覆盖：

  [Client]
  UserIdentifier=shortmquser
  

  配置生效后，所有使用该MQ客户端的应用都会采用这个短用户标识。

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