无需安装IBM MQ客户端，.NET Core应用连接报错dspmqver未找到的解决方法

我正在开发一个.NET Core应用以连接IBM MQ，因客户限制无法安装IBM MQ客户端，目前使用amqmdnetstd.dll（9.3.2.0）进行连接。IBM MQ服务器与应用部署在不同系统中，使用的连接代码片段如下：

MQQueue objMQQueue;
MQMessage objPutMQMessage;
MQMessage objReadMQMessage;
MQQueueManager objMQQueueManager;

string SSLCipher = string.Empty;
string SLLKey = string.Empty;
string QueueManager = string.Empty;
string QueueChannel = string.Empty;
string ConnectionName = string.Empty;
SSLCipher = ibmOptions.SSLCipher;
SLLKey = ibmOptions.SLLKey;

X509Certificate2 certificate = new X509Certificate2(SLLKey, ibmOptions.SLLKeyPassword);
Hashtable properties = new Hashtable();
properties.Add(MQC.TRANSPORT_PROPERTY, MQC.TRANSPORT_MQSERIES_MANAGED);
properties.Add(MQC.SSL_CERT_STORE_PROPERTY, certificate);

Console.WriteLine(DateTime.Now.ToLongTimeString() + " Certificate object  " + JsonConvert.SerializeObject(certificate));

QueueManager = ibmOptions.QueueManager;
QueueChannel = ibmOptions.QueueChannel;
ConnectionName = ibmOptions.ConnectionName;
MQEnvironment.SSLCipherSpec = SSLCipher;           //SSL Encryption Method

MQEnvironment.properties.Add("KeyRepository", properties);

objMQQueueManager = new MQQueueManager(QueueManager, QueueChannel, ConnectionName);

objMQQueue = objMQQueueManager.AccessQueue("FTS.FCUBS.IN.UAT", MQC.MQOO_OUTPUT + MQC.MQOO_FAIL_IF_QUIESCING);
objPutMQMessage = new MQMessage();
//UTF-8 character encoding
objPutMQMessage.CharacterSet = 1208;
objPutMQMessage.WriteString("Test data");
objPutMQMessage.Format = MQC.MQFMT_STRING;
objPutMQMessage.MessageType = MQC.MQMT_REQUEST;
objPutMQMessage.Report = MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID;
objPutMQMessage.ReplyToQueueName = "FTS.FCUBS.OUT.UAT";
objMQQueue.Put(objPutMQMessage);
objMQQueueManager.Commit();

if (objMQQueue.OpenStatus)
{
 objMQQueue.Close();
}

现在遇到了dspmqver Command not found错误，已知该错误因应用服务器未安装客户端库导致，求无需安装客户端的解决办法。

• 核心原因解析：dspmqver是IBM MQ本地客户端的命令行工具，你使用的amqmdnetstd.dll是纯.NET托管客户端，本身不需要依赖本地客户端或该命令。错误出现是因为代码中的SSL配置错误，导致客户端尝试加载非托管组件，进而触发对该命令的查找。

• 修正配置错误：

  1. 移除错误的KeyRepository配置：MQEnvironment.properties.Add("KeyRepository", properties);这行代码完全错误，KeyRepository是给非托管客户端使用的配置项，托管客户端不需要设置。
  2. 正确配置托管客户端的SSL证书：托管客户端支持直接传递X509Certificate2对象，需要使用MQC.SSL_CLIENT_CERTIFICATE_PROPERTY属性，而非SSL_CERT_STORE_PROPERTY（后者用于指定证书存储名称，而非直接传递证书对象）。

• 修正后的代码片段：

MQQueue objMQQueue;
MQMessage objPutMQMessage;
MQMessage objReadMQMessage;
MQQueueManager objMQQueueManager;

string SSLCipher = ibmOptions.SSLCipher;
string SLLKey = ibmOptions.SLLKey;
string QueueManager = ibmOptions.QueueManager;
string QueueChannel = ibmOptions.QueueChannel;
string ConnectionName = ibmOptions.ConnectionName;

// 加载客户端证书
X509Certificate2 certificate = new X509Certificate2(SLLKey, ibmOptions.SLLKeyPassword);

Hashtable properties = new Hashtable();
// 指定使用托管传输，无需本地MQ客户端
properties.Add(MQC.TRANSPORT_PROPERTY, MQC.TRANSPORT_MQSERIES_MANAGED);
// 直接传递客户端证书
properties.Add(MQC.SSL_CLIENT_CERTIFICATE_PROPERTY, certificate);
// 设置SSL加密套件
properties.Add(MQC.SSL_CIPHER_SPEC_PROPERTY, SSLCipher);
// 指定通道和连接地址
properties.Add(MQC.CHANNEL_PROPERTY, QueueChannel);
properties.Add(MQC.CONNECTION_NAME_PROPERTY, ConnectionName);

Console.WriteLine(DateTime.Now.ToLongTimeString() + " Certificate object  " + JsonConvert.SerializeObject(certificate));

// 使用带properties参数的构造函数初始化队列管理器，而非依赖MQEnvironment
objMQQueueManager = new MQQueueManager(QueueManager, properties);

objMQQueue = objMQQueueManager.AccessQueue("FTS.FCUBS.IN.UAT", MQC.MQOO_OUTPUT + MQC.MQOO_FAIL_IF_QUIESCING);
objPutMQMessage = new MQMessage();
// UTF-8字符编码
objPutMQMessage.CharacterSet = 1208;
objPutMQMessage.WriteString("Test data");
objPutMQMessage.Format = MQC.MQFMT_STRING;
objPutMQMessage.MessageType = MQC.MQMT_REQUEST;
objPutMQMessage.Report = MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID;
objPutMQMessage.ReplyToQueueName = "FTS.FCUBS.OUT.UAT";
objMQQueue.Put(objPutMQMessage);
objMQQueueManager.Commit();

if (objMQQueue.OpenStatus)
{
    objMQQueue.Close();
}

• 额外注意事项：
  • 确保amqmdnetstd.dll及其依赖组件（如IBM.MQ.Common.dll）已正确部署到应用目录，建议通过NuGet包IBM.MQDotNetStd安装，而非手动复制dll，避免依赖缺失。
  • 确认IBM MQ服务器端已配置对应SSL cipher spec，且信任你的客户端证书。
  • 避免使用MQEnvironment全局配置，推荐通过构造函数传递Hashtable参数，提升代码的可维护性和线程安全性。

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