IBM MQ网络中断引发消息丢失问题求助

问题背景 #

使用IBMXMSDotnetClient 9.2.5.0的.NET客户端，基于ClientAcknowledge确认模式从MQ服务器消费消息，在客户端与服务器临时断开网络后出现消息丢失现象，且未在业务代码中找到丢失痕迹，同时捕获到异常：

IBM.XMS.XMSException: MQ delivered an asynchronous event with completion code 0, and reason 2545. XMSWMQ2014.explanation XMSWMQ2014.useraction Linked Exception : CompCode: 0, Reason: 2545

排查建议 #

• 明确2545错误的核心含义
  MQ原因码2545（MQRC_ASYNC_ERROR_OCCURRED）表示客户端处理异步事件时触发未预期错误，通常与网络中断导致的连接/会话不稳定直接相关，此时客户端的会话可能已处于失效或半失效状态。

• 补全连接/会话的异常监听逻辑
  当前代码仅配置了MessageListener，未处理连接层面的异常。需为Connection或Session设置ExceptionListener，及时捕获连接断开、会话失效等异常，避免未确认消息的状态混乱：

  connection.ExceptionListener = exception =>
  {
      // 记录完整异常栈信息，定位异常触发点
      // 执行连接重建、会话与消费者重启逻辑
  };
  

• 分析ClientAcknowledge模式下的消息流转
  ClientAcknowledge采用累积确认机制：调用message.Acknowledge()会确认当前会话中所有已接收但未确认的消息。针对网络断开场景：

  1. 若断开发生在消息接收后、确认前：MQ服务器会认为消息未被消费，连接恢复后应重新投递，需检查是否因重试次数耗尽（队列BackoutThreshold配置）导致消息被移至死信队列（DLQ），而未被排查到。
  2. 若断开导致会话失效：需确认服务器端是否将未确认消息重新放回原队列，同时检查客户端重连后是否重新创建消费者并从正确位置开始消费。

• 检查客户端重连配置
  确认是否开启WMQ_CONNECTION_RECONNECT和WMQ_CONNECTION_RECONNECT_TIMEOUT参数。未开启自动重连时，连接断开后会话直接失效，未确认消息的状态无法同步；开启重连后，需验证重连后的会话是否重新绑定消费者，能否继续处理未确认消息。

• 排查MQ服务器端日志
  查看队列管理器的错误日志（如AMQERR01.LOG），重点关注网络断开前后的日志：

  • 连接断开的具体触发原因（TCP中断、心跳超时等）
  • 未确认消息的后续处理（是否重回队列、是否移入DLQ）
  • 是否存在队列满、权限异常等其他导致消息丢失的场景

• 确保消息处理逻辑幂等
  网络异常场景下消息重复投递无法完全避免，必须保证业务处理逻辑具备幂等性，即重复处理同一条消息不会引发业务异常，这是MQ消费场景的基础要求。

• 升级XMS客户端版本
  IBM在9.2.5.0之后的版本（如9.2.6及以上）修复了部分异步处理、重连相关的bug，建议升级至最新稳定版，排查是否为版本已知问题导致的消息丢失。

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