Skip to content

Troubleshooting

This section collects the most common issues encountered when using ServiceBus.Core and ServiceBus.Core.Rabbit.

The goal is to help identify configuration problems, topology mistakes and runtime failures more quickly.

Common Problem Areas

Most issues fall into one of the following categories:

Area Typical Symptoms
Connection Unable to connect to RabbitMQ.
Serialization Messages cannot be serialized or deserialized.
Topology Exchanges, queues or bindings are missing.
Retry Messages are not retried as expected.
Delivery Confirmation Publishers do not receive acknowledgements.
Channel Events Unexpected channel shutdowns or callback exceptions.

When investigating a problem:

  1. Verify the RabbitMQ connection.
  2. Verify the formatter configuration.
  3. Verify the descriptor configuration.
  4. Verify the generated RabbitMQ topology.
  5. Verify publisher and subscriber logs.
  6. Enable channel events when additional diagnostics are needed.
graph TD

    Connection["Connection"]

    Formatter["Formatter"]

    Descriptor["Descriptor"]

    Topology["RabbitMQ Topology"]

    Runtime["Runtime Behavior"]

    Connection --> Formatter

    Formatter --> Descriptor

    Descriptor --> Topology

    Topology --> Runtime

Useful Tools

The following RabbitMQ tools are useful when troubleshooting:

  • RabbitMQ Management UI
  • RabbitMQ Logs
  • RabbitMQ Definitions Export
  • RabbitMQ Queue Inspection
  • RabbitMQ Exchange Inspection

See:

RabbitMQ / Concepts
RabbitMQ / How To
RabbitMQ / Reference

for additional details regarding topology and runtime behavior.