.NET Core中MassTransit发布Azure Service Bus消息挂起问题排查

• 缺失总线托管服务注册（最高发原因）
  你当前的配置仅调用了AddMassTransit完成容器注册，没有添加MassTransit的托管服务来在应用启动时初始化并启动消息总线。这种状态下IPublishEndpoint依赖的IBus实例始终未就绪，Publish方法会无限等待总线启动完成，直接表现为无响应挂起。
  修复方式是在MassTransit注册代码后追加托管服务配置：

  services.AddMassTransit(x =>
  {
      x.UsingAzureServiceBus((busContext, busConfig) =>
      {
          busConfig.Host("your service bus connection string");
          busConfig.ConfigureEndpoints(busContext);
      });
  });
  // 追加这行，由.NET Core托管生命周期启动总线
  services.AddMassTransitHostedService();
  

  MassTransit 8.x+版本虽然提供了自动注册托管服务的简化写法，但手动编写配置时漏加这行是该类故障的最常见诱因。
• 调用链路存在隐式同步阻塞
  即使你调整了上层方法的async/await写法，仍需要检查全链路是否存在同步等待异步方法的代码，比如对QueueMessage调用使用了.Result、.Wait()，或者在非异步的中间件、Action过滤器中直接调用返回Task但未await的方法。这类写法会触发异步上下文死锁，导致异步任务永远无法调度回线程池完成执行，表现为方法永久挂起。
• 网络/权限问题导致连接长时间无响应
  检查Azure Service Bus连接字符串是否配置正确、是否持有消息发送的对应权限，同时确认运行环境可以正常连通Service Bus的AMQP端口（5671/5672）：本地代理拦截、企业防火墙规则拦截、VNet配置错误都会导致连接无法建立。MassTransit默认会持续重试连接，没有配置操作超时的话就会表现为长时间挂起。可以临时配置超时快速定位问题：

  busConfig.Host("your connection string", cfg =>
  {
      cfg.OperationTimeout = TimeSpan.FromSeconds(10);
  });
  

  配置后如果是连通性问题会直接抛出超时异常，不会一直阻塞。
• 消息契约序列化异常被吞
  检查你使用的Message契约类是否满足序列化要求：需要有公开无参构造函数、所有待序列化属性具备公开get/set访问器、不存在循环引用或无法序列化的属性类型。如果序列化阶段抛出的异常被全局异常处理逻辑吞掉，也可能表现为方法无返回，这类问题出现概率相对前三个更低。

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