配置MSMQ的NServiceBus 6.4.3启动失败技术求助

作为经常处理NServiceBus和MSMQ集成问题的开发者，我给你梳理几个最常见的问题点和修复方法：

• 队列名称格式不对是重灾区
  NServiceBus识别MSMQ私有队列需要完整的路径格式：.\Private$\myappqueue，而不是你代码里直接用的myappqueue。你手动创建的私有队列实际路径是这个完整格式，所以要么修改端点配置的名称：

  var endpointConfiguration = new EndpointConfiguration(@".\Private$\myappqueue");
  

  要么通过传输配置明确指定队列连接字符串：

  var transport = endpointConfiguration.UseTransport<MsmqTransport>();
  transport.ConnectionString(@"FormatName:DIRECT=OS:.\Private$\myappqueue");
  

• 权限不足导致无法访问队列
  运行你程序的账户（比如当前登录用户）必须拥有这个MSMQ队列的读写权限。你可以这么检查：

  1. 打开「计算机管理」→「服务和应用程序」→「消息队列」→「私有队列」
  2. 右键myappqueue选「属性」→「安全」标签
  3. 添加运行程序的账户，给它分配「完全控制」或者至少「读取、写入、删除消息」的权限

• .Result引发的死锁坑
  在控制台程序的Main方法里直接用.Result等待异步操作，很容易触发死锁，导致端点启动卡住甚至失败。换成异步Main方法就好：

  static async Task Main(string[] args) { 
      var endpointConfiguration = new EndpointConfiguration(@".\Private$\myappqueue"); 
      endpointConfiguration.UseTransport<MsmqTransport>(); 
      var endpointInstance = await Endpoint.Start(endpointConfiguration); 
      Console.WriteLine("端点启动成功！");
      Console.ReadKey(); 
      await endpointInstance.Stop(); 
  }
  

  注意要在项目属性的「高级」设置里启用C# 7.1及以上的语言版本，才能支持异步Main。

• 检查MSMQ组件和服务状态
  确认你装全了MSMQ的必要组件：「消息队列服务器」、「消息队列客户端」都要勾选（在控制面板的「启用或关闭Windows功能」里）。另外，打开服务管理器，确保「消息队列」服务（MSMQ）是运行状态，没启动的话手动启动它。

• 抓异常信息精准定位
  上面的方法都试了还不行？那就加个异常捕获，把错误信息打出来，比如：

  static async Task Main(string[] args) { 
      try
      {
          var endpointConfiguration = new EndpointConfiguration(@".\Private$\myappqueue"); 
          endpointConfiguration.UseTransport<MsmqTransport>(); 
          var endpointInstance = await Endpoint.Start(endpointConfiguration); 
          Console.WriteLine("端点启动成功！");
          Console.ReadKey(); 
          await endpointInstance.Stop(); 
      }
      catch (Exception ex)
      {
          Console.WriteLine($"启动失败：{ex.Message}");
          if (ex.InnerException != null)
              Console.WriteLine($"内部错误：{ex.InnerException.Message}");
          Console.ReadKey();
      }
  }
  

  比如如果提示“队列不存在”，那就是路径没配对；如果提示“权限被拒绝”，就去调队列权限。

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