Windows服务器上ASP.NET Core 3.1连接MQ报MQRC_Q_MGR_NOT_AVAILABLE错误

基础连通性排查 #

• 验证网络连通性：在Windows服务器上执行Test-NetConnection <MQ主机名> -Port <端口号>，确认能正常连通。如果不通，检查Windows本地防火墙、MQ服务器端防火墙是否开放对应端口，或者网络路由是否存在问题。
• 核对队列管理器名称：确保代码中queueManagerName的值与MQ服务器上的队列管理器名称完全一致，MQ对名称大小写敏感。

SSL/TLS配置校验 #

• 统一Cipher参数配置：代码中同时设置了SSL_CIPHER_SUITE_PROPERTY和SSL_CIPHER_SPEC_PROPERTY，对于IBM MQ .NET托管客户端，仅需设置SSL_CIPHER_SPEC_PROPERTY，且其值必须与MQ队列管理器通道配置的Cipher Spec完全匹配（比如队列管理器用TLS_RSA_WITH_AES_128_CBC_SHA256，则代码中保留该参数，删除SSL_CIPHER_SUITE_PROPERTY的设置）。
• 证书信任检查：代码指定证书存储为*USER，需确保ASP.NET Core应用运行身份（如IIS应用池账户）的个人证书存储中，已导入MQ服务器的根CA证书（单向认证场景）或客户端证书（双向认证场景）。可通过certmgr.msc切换到对应用户的证书存储查看。
• 确认通道SSL配置：检查MQ队列管理器的目标通道，确保已启用SSL/TLS，且SSLCAUTH参数设置符合需求：若为REQUIRED，客户端必须提供有效证书；若为OPTIONAL，客户端需信任服务器证书即可。

MQ客户端与代码修正 #

• 核对客户端版本：确保项目引用的IBM MQ .NET Client NuGet包（IBM.MQ.Core、IBM.MQ.Core.Client）版本兼容ASP.NET Core 3.1，建议使用9.1及以上版本。
• 移除冗余连接调用：在新版MQ .NET客户端中，MQQueueManager构造函数会自动尝试建立连接，无需额外调用_queueManager.Connect()，删除该代码可避免潜在异常。
• 完善异常日志：捕获MQException时，除记录Message，还需记录ReasonCode和CompletionCode，便于精准定位问题，示例代码：

catch (MQException exp)
{
    _logger.LogInformation("连接失败: 错误码={ReasonCode}, 信息={Message}", exp.ReasonCode, exp.Message);
}

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