NServiceBus消息滞留未处理：v3应用发往v4应用需重启IIS才处理

我之前碰到过类似跨版本NServiceBus的问题，结合你的场景——应用2（v3）发消息到应用1（v4）时，消息躺在队列里必须重启IIS才会被处理，大概率是消息接收端的监听机制或应用进程状态导致的，下面给你一步步排查和解决的思路：

一、先确认应用1的NServiceBus总线是否正确启动 #

在ASP.NET Web应用里，NServiceBus的总线必须在应用启动时正确初始化并启动，否则不会主动监听队列。你可以检查应用1的Global.asax文件里的Application_Start方法，确保有类似这样的代码：

protected void Application_Start()
{
    // 初始化并启动NServiceBus总线
    var bus = Configure.With()
        .DefaultBuilder()
        .XmlSerializer() // 确保和v3用相同的序列化器，默认都是Xml
        .MsmqTransport()
            .IsTransactional(true)
            .PurgeOnStartup(false) // 不要启动时清空队列，避免丢失消息
        .UnicastBus()
            .LoadMessageHandlers() // 加载消息处理程序
        .CreateBus()
        .Start(); // 关键！必须调用Start才会开始监听队列
}

如果之前漏了.Start()方法，那总线根本没开始工作，只有重启应用时才会触发初始化，这就解释了为什么重启后能处理消息。

二、解决ASP.NET应用池休眠的问题 #

ASP.NET应用池默认会在闲置20分钟后自动休眠，这时候NServiceBus的监听线程也会跟着停止，自然没法实时接收队列里的消息。你可以通过以下两种方式解决：

• 修改应用池高级设置：
  打开IIS管理器，找到应用1对应的应用池，右键选择「高级设置」：
  • 把「闲置超时（分钟）」改成0，禁用闲置休眠
  • 把「定期时间间隔（分钟）」改成0，禁用定期进程回收
• 添加心跳保活机制：
  可以在应用1里创建一个简单的KeepAlive.ashx处理程序，然后用Windows任务计划定期（比如每10分钟）请求这个地址，强制保持应用进程处于激活状态。

三、检查消息队列的配置与权限 #

1. 确认队列配置正确性 #

检查应用1的app.config里的Msmq相关配置，确保输入队列指向正确：

<configSections>
  <section name="MsmqTransportConfig" type="NServiceBus.Config.MsmqTransportConfig, NServiceBus.Core" />
  <section name="MessageForwardingInCaseOfFault" type="NServiceBus.Config.MessageForwardingInCaseOfFaultConfig, NServiceBus.Core" />
</configSections>

<!-- 确保InputQueue是应用1的专属队列 -->
<MsmqTransportConfig InputQueue="Application1_InputQueue" ErrorQueue="error" NumberOfWorkerThreads="1" MaxRetries="5" />
<MessageForwardingInCaseOfFault ErrorQueue="error" />

注意NumberOfWorkerThreads至少设置为1，保证有线程处理消息。

2. 验证队列权限 #

如果应用池的身份没有队列的读取权限，也可能导致无法实时获取消息。你可以：

• 打开「计算机管理」→「服务和应用程序」→「消息队列」→「私有队列」
• 找到应用1的输入队列，右键「属性」→「安全」选项卡
• 添加应用池的身份（比如IIS AppPool\你的应用池名称），授予「读取」「写入」「删除」权限

四、确认消息序列化兼容性 #

虽然重启后能处理，但还是要确保两个版本的NServiceBus用的是相同的序列化器——v3和v4默认都是XmlSerializer，所以只要你没自定义序列化配置，这个问题大概率不存在，但可以检查应用2的app.config里的消息端点映射是否正确，确保消息类型能被应用1识别：

<UnicastBusConfig>
  <MessageEndpointMappings>
    <!-- 把你的消息命名空间映射到应用1的队列 -->
    <add Messages="YourSharedMessageNamespace" Endpoint="Application1_InputQueue" />
  </MessageEndpointMappings>
</UnicastBusConfig>

按上面的步骤逐一排查，应该能解决消息需要重启才被处理的问题。

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