Excepciones de mensajería de Event Hubs: .NET (heredadas)

  • Artículo

En esta sección se enumeran las excepciones de .NET generadas por API de .NET Framework.

Importante

Algunas de las excepciones enumeradas en el artículo solo se aplican a la biblioteca heredada .NET de Event Hubs. Por ejemplo: Excepciones de Microsoft.ServiceBus.*

Para información sobre las excepciones EventHubsException generadas por la nueva biblioteca .NET, consulte EventHubsException: .NET.

El 30 de septiembre de 2026, retiraremos las bibliotecas del SDK de Azure Service Bus WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus y com.microsoft.azure.servicebus, que no se ajustan a las directrices del SDK de Azure. También finalizaremos la compatibilidad con el protocolo SBMP, por lo que ya no podrá usar este protocolo después del 30 de septiembre de 2026. Migre a las bibliotecas más recientes del SDK de Azure, que ofrecen actualizaciones de seguridad críticas y funcionalidades mejoradas, antes de esa fecha.

Aunque las bibliotecas anteriores todavía se pueden usar después del 30 de septiembre de 2026, ya no recibirán soporte técnico oficial ni actualizaciones de Microsoft. Para obtener más información, consulte el anuncio de retirada de soporte técnico.

Categorías de excepciones

Las API de .NET de Event Hubs generan excepciones que pueden dividirse en las siguientes categorías, junto con la acción asociada que puede realizar para intentar corregirlas:

Tipos de excepciones

En la tabla siguiente se describen los tipos de excepción de mensajería, sus causas y las acciones sugeridas que puede realizar.

Tipo de excepción Descripción/causa/ejemplos Acción sugerida Nota sobre el reintento automático o inmediato
TimeoutException El servidor no respondió a la operación solicitada en el tiempo especificado, que está controlado por OperationTimeout. Puede que el servidor haya completado la operación solicitada. Esta excepción se puede producir debido a un retraso de red o a otros retrasos de infraestructura. Compruebe la coherencia del estado del sistema y vuelva a intentarlo si es necesario.
Consulte TimeoutException.		 El reintento podría resultar útil en algunos casos; agregue lógica de reintento al código.
InvalidOperationException La operación del usuario solicitada no está permitida en el servidor o servicio. Consulte el mensaje de excepción para obtener detalles. Por ejemplo, Complete genera esta excepción si el mensaje se recibió en el modo ReceiveAndDelete . Compruebe el código y la documentación. Asegúrese de que la operación solicitada sea válida. Los reintentos no funcionan.
OperationCanceledException Se realiza un intento para invocar una operación en un objeto que ya se ha cerrado, anulado o eliminado. En raras ocasiones, la transacción de ambiente ya se ha eliminado. Compruebe el código y asegúrese de que no invoca operaciones de un objeto desechado. Los reintentos no funcionan.
UnauthorizedAccessException El objeto TokenProvider no pudo adquirir un token, el token no es válido o no contiene las notificaciones necesarias para realizar la operación. Asegúrese de que el proveedor de tokens se cree con los valores correctos. Compruebe la configuración de Access Control Service. El reintento podría resultar útil en algunos casos; agregue lógica de reintento al código.
ArgumentException
ArgumentNullException
ArgumentOutOfRangeException		 Uno o varios de los argumentos proporcionados para el método no son válidos. El URI proporcionado a NamespaceManager o Create contiene segmentos de ruta de acceso. El esquema de URI proporcionado a NamespaceManager o Create no es válido. El valor de la propiedad es mayor de 32 KB. Compruebe el código de llamada y asegúrese de que los argumentos sean correctos. El reintento no le será de ayuda.
Microsoft.ServiceBus.Messaging MessagingEntityNotFoundException

Microsoft.Azure.EventHubs MessagingEntityNotFoundException		 La entidad asociada a la operación no existe o se eliminó. Asegúrese de que la entidad exista. El reintento no le será de ayuda.
MessagingCommunicationException El cliente no puede establecer una conexión al Event Hubs. Asegúrese de que el nombre de host proporcionado sea correcto y que este sea accesible. El reintento podría resultar útil si hay problemas de conectividad intermitente.
Microsoft.ServiceBus.Messaging ServerBusyException

Microsoft.Azure.EventHubs ServerBusyException		 El servicio no puede procesar la solicitud en este momento. El cliente puede esperar durante un período de tiempo y volver a intentar realizar la operación.
Consulte ServerBusyException.		 El cliente puede volver a intentarlo tras un determinado intervalo de tiempo. Si el reintento genera otra excepción, compruebe el comportamiento de reintento de esa excepción.
MessagingException Excepción de mensajería genérica que puede producirse en los siguientes casos: Se intentó crear QueueClient con un nombre o una ruta de acceso que pertenece a un tipo de entidad diferente (por ejemplo, un tema). Intento de enviar un mensaje mayor de 1 MB. El servidor o servicio encontró un error durante el procesamiento de la solicitud. Consulte el mensaje de excepción para obtener detalles. Por lo general, se trata de una excepción transitoria. Compruebe el código y asegúrese de que solo se usan objetos serializables en el cuerpo del mensaje (o use un serializador personalizado). Consulte la documentación de los tipos de valor de las propiedades admitidos y use solo los tipos compatibles. Compruebe la propiedad IsTransient . Si es true, puede volver a intentar la operación. El comportamiento de reintento es indefinido y quizá no resulte útil.
MessagingEntityAlreadyExistsException Se intenta crear una entidad con un nombre que ya se usa en otra entidad de ese espacio de nombres de servicio. Elimine la entidad existente o elija un nombre diferente para la entidad que quiere crear. El reintento no le será de ayuda.
QuotaExceededException La entidad de mensajería alcanzó su tamaño máximo permitido. Esta excepción puede suceder si ya ha abierto el número máximo de destinatarios (que es cinco) en un nivel de grupo por consumidor. Cree espacio en la entidad recibiendo mensajes de esta o de sus subcolas.
Consulte QuotaExceededException.		 El reintento podría resultar útil si los mensajes se eliminan mientras este se lleva a cabo.
MessagingEntityDisabledException Solicitud para realizar una operación en tiempo de ejecución en una entidad deshabilitada. Active la entidad. El reintento podría ser útil si la entidad se activa mientras este se lleva a cabo.
Microsoft.ServiceBus.Messaging MessageSizeExceededException

Microsoft.Azure.EventHubs MessageSizeExceededException		 Carga de mensaje que supera el límite de 1 MB. Este límite de 1 MB es para el mensaje total, que puede incluir propiedades del sistema y cualquier sobrecarga .NET. Reduzca el tamaño de la carga del mensaje y vuelva a intentar la operación. El reintento no le será de ayuda.

QuotaExceededException

QuotaExceededException indica que se ha superado una cuota de una entidad específica.

Esta excepción suceder si ya ha abierto el número máximo de destinatarios (cinco) en un nivel de grupo por consumidor.

Event Hubs

Event Hubs tiene un límite de 20 grupos de consumidores por instancia. Cuando intenta crear más, recibe QuotaExceededException.

TimeoutException

TimeoutException indica que la operación iniciada por el usuario está superando el tiempo de espera.

Para Event Hubs, el tiempo de espera se especifica como parte de la cadena de conexión o a través de ServiceBusConnectionStringBuilder. El propio mensaje de error puede variar, pero siempre contiene el valor de tiempo de espera especificado para la operación actual.

Se espera que se produzcan tiempos de espera durante o entre operaciones de mantenimiento, por ejemplo, actualizaciones del servicio de Event Hubs o actualizaciones del sistema operativo en los recursos que ejecutan el servicio. Durante las actualizaciones del sistema operativo, las entidades se mueven y los nodos se actualizan o se reinician, lo que puede provocar tiempos de espera. Para obtener detalles sobre el contrato de nivel de servicio (SLA) del servicio Azure Event Hubs, vea SLA para Event Hubs.

Causas comunes

Hay dos causas comunes de este error: configuración incorrecta o un error de servicio transitorio.

  • Configuración incorrecta : es posible que el tiempo de espera de la operación sea demasiado breve para la condición operativa. El valor predeterminado para el tiempo de espera de la operación en el SDK de cliente es 60 segundos. Compruebe si su código tiene el valor establecido en algo demasiado pequeño. La condición de la red y el uso de CPU pueden afectar al tiempo que tarda en completarse una operación particular, por lo que el tiempo de espera de esta no debe establecerse en un valor pequeño.
  • Error de servicio transitorio: a veces, el servicio Event Hubs puede experimentar retrasos en el procesamiento de solicitudes; por ejemplo, durante períodos de tráfico elevado. En tales casos, puede reintentar su operación después de un retraso hasta que la operación se realice correctamente. Si la misma operación aún experimenta errores después de varios intentos, visite el sitio de estado del servicio de Azure para ver si hay interrupciones del servicio conocidas.

ServerBusyException

Una excepción Microsoft.ServiceBus.Messaging.ServerBusyException o Microsoft.Azure.EventHubs.ServerBusyException indica que un servidor está sobrecargado. Hay dos códigos de error relevantes para esta excepción.

Código de error 50002

Este error puede producirse por uno de estos dos motivos:

  • La carga no se distribuye uniformemente entre todas las particiones del centro de eventos y una partición ha alcanzado la limitación de unidades de rendimiento local.

    Solución: revisar la estrategia de distribución de particiones o probar EventHubClient.Send(eventDataWithOutPartitionKey) puede que le sirva de ayuda.

  • El espacio de nombres de Event Hubs no tiene suficientes unidades de rendimiento (puede comprobar la pantalla Métrica en la ventana de espacio de nombres de Event Hubs en Azure Portal para confirmar). El portal muestra información agregada (un minuto), pero el rendimiento se mide en tiempo real, por lo que esto es solo una estimación.

    Solución: aumentar las unidades de rendimiento en el espacio de nombres puede resultar útil.

    Puede configurar unidades de procesamiento en la página Escala o en la página de Información general de la página Espacio de nombres de Event Hubs de Azure Portal. También puede usar la característica de inflado automático que escala verticalmente y de forma automática mediante el aumento del número de unidades de procesamiento para responder a las necesidades de utilización.

    Las unidades de procesamiento (TU) se aplican a todos los centros de eventos de un espacio de nombres de Event Hubs. Significa que las TU se compran en el nivel de espacio de nombres y se comparten entre los centros de eventos de ese espacio de nombres. Cada TU da al espacio de nombres derecho a las siguientes funcionalidades:

    • Hasta 1 MB por segundo de eventos de entrada (eventos enviados a un centro de eventos), pero no más de 1000 eventos de entrada, operaciones de administración o llamadas a la API de control por segundo.
    • Hasta 2 MB por segundo de eventos de salida (eventos consumidos de un centro de eventos), pero no más de 4096 eventos de salida.
    • Hasta 84 GB de almacenamiento de eventos (suficiente para el período de retención predeterminado de 1 hora).

    En la página Información general, en la sección Mostrar métricas, cambie a la pestaña Rendimiento. Seleccione el gráfico para abrirlo en una ventana más grande con intervalos de 1 minuto en el eje X. Examine los valores máximos y divídalos por 60 para obtener los bytes entrantes por segundo o los bytes salientes por segundo. Use un enfoque similar para calcular el número de solicitudes por segundo en las horas punta desde la pestaña Solicitudes.

    Si ve valores mayores que el número TU x límites (1 MB por segundo para la entrada o 1000 solicitudes para entrada/segundo, 2 MB por segundo para la salida), aumente el número de TU a través de la página Escala (en el menú izquierdo) de un espacio de nombres de Event Hubs para realizar un escalado superior manualmente o para usar la característica inflado automático de Event Hubs. Puede escalar verticalmente hasta 40 RU cuando se escala manualmente o automáticamente el espacio de nombres.

Código de error 50008

Este error se produce raras veces. Se produce cuando el contenedor que ejecuta el código para su espacio de nombres hace un uso bajo de la CPU: no más de unos pocos segundos antes de que comience el equilibrador de carga de Event Hubs.

Solución: Límite las llamadas al método GetRuntimeInformation. Azure Event Hubs admite hasta 50 llamadas al método GetRuntimeInfo por segundo y por grupo de consumidores. Una vez que se alcanza el límite, puede recibir una excepción similar a esta:

ExceptionId: 00000000000-00000-0000-a48a-9c908fbe84f6-ServerBusyException: The request was terminated because the namespace 75248:aaa-default-eventhub-ns-prodb2b is being throttled. Error code : 50008. Please wait 10 seconds and try again.

Pasos siguientes

Para más información acerca de Event Hubs, visite los vínculos siguientes: