Service Bus 메시징 예외(사용되지 않음)

이 문서에서는 .NET Framework API에서 생성된 .NET 예외를 나열합니다.

2026년 9월 30일에 Azure SDK 지침을 따르지 않는 Azure Service Bus SDK 라이브러리 WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus 및 com.microsoft.azure.servicebus를 사용 중지합니다. 또한 SBMP 프로토콜에 대한 지원이 종료되므로 2026년 9월 30일 이후에는 더 이상 이 프로토콜을 사용할 수 없습니다. 해당 날짜 전에 중요한 보안 업데이트와 개선된 기능을 제공하는 최신 Azure SDK 라이브러리로 마이그레이션하세요.

이전 라이브러리는 2026년 9월 30일 이후에도 계속 사용할 수 있지만 더 이상 Microsoft로부터 공식 지원 및 업데이트를 받을 수 없습니다. 자세한 내용은 지원 종료 공지를 참조하세요.

예외 범주

메시징 API는 다음 범주에 속할 수 있는 예외와 이를 해결하기 위해 수행할 수 있는 관련 작업을 생성합니다. 예외의 의미와 원인은 메시징 엔터티의 유형에 따라 달라질 수 있습니다.

1. 사용자 코딩 오류(System.ArgumentException, System.InvalidOperationException, System.OperationCanceledException, System.Runtime.Serialization.SerializationException). 일반 작업: 계속하기 전에 코드를 수정합니다.
2. 설치/구성 오류(Microsoft.ServiceBus.Messaging.MessagingEntityNotFoundException, System.UnauthorizedAccessException) 일반 작업: 구성을 검토하고 필요한 경우 변경합니다.
3. 일시적인 예외(Microsoft.ServiceBus.Messaging.MessagingException, Microsoft.ServiceBus.Messaging.ServerBusyException, Microsoft.ServiceBus.Messaging.MessagingCommunicationException). 일반 작업: 작업을 다시 시도하거나 사용자에게 알립니다. 클라이언트 SDK의 클래스는 RetryPolicy 재시도를 자동으로 처리하도록 구성할 수 있습니다. 자세한 내용은 다시 시도 지침을 참조하세요.
4. 기타 예외(System.Transactions.TransactionException, System.TimeoutException, Microsoft.ServiceBus.Messaging.MessageLockLostException, Microsoft.ServiceBus.Messaging.SessionLockLostException). 일반 작업: 예외 유형에 따라 다릅니다. 은 다음 섹션의 표를 참조하세요.

예외 유형

다음 표에는 메시징 예외 유형 및 해당 원인과 수행할 수 있는 제안된 작업이 나와 있습니다.

할당량 초과 예외

QuotaExceededException 은 특정 엔터티에 대한 할당량이 초과됐음을 나타냅니다.

큐 및 토픽

큐 및 토픽의 경우 이는 큐의 크기인 경우가 많습니다. 다음 예제와 같이 오류 메시지 속성은 추가 세부 정보를 포함합니다.

Microsoft.ServiceBus.Messaging.QuotaExceededException
Message: The maximum entity size has been reached or exceeded for Topic: 'xxx-xxx-xxx'. 
    Size of entity in bytes:1073742326, Max entity size in bytes:
1073741824..TrackingId:xxxxxxxxxxxxxxxxxxxxxxxxxx, TimeStamp:3/15/2013 7:50:18 AM

메시지는 토픽이 해당 크기 제한을 초과했음을 알려 줍니다. 이 경우 1GB입니다(기본 크기 제한).

네임스페이스

네임스페이스의 경우 QuotaExceededException 은 애플리케이션이 네임스페이스에 대한 최대 연결 수를 초과했음을 나타낼 수 있습니다. 다음은 그 예입니다.

Microsoft.ServiceBus.Messaging.QuotaExceededException: ConnectionsQuotaExceeded for namespace xxx.
<tracking-id-guid>_G12 ---> 
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]: 
ConnectionsQuotaExceeded for namespace xxx.

일반적인 원인

이 오류에 대한 두 가지 일반적인 원인은 배달 못 한 편지 큐와 정상적으로 작동하지 않는 메시지 수신기입니다.

1. 배달 못 한 편지 큐 판독기는 메시지 완료에 실패하고 잠금이 만료되면 메시지는 큐/토픽으로 반환됩니다. 판독기에서 BrokeredMessage.Complete를 호출하지 못하게 하는 예외가 발생하는 경우 발생할 수 있습니다. 메시지는 10번 읽혀진 후 기본적으로 배달 못 한 편지 큐로 이동합니다. 이 동작은 QueueDescription.MaxDeliveryCount 속성에 의해 제어되며 기본값은 10입니다. 메시지는 배달 못 한 편지 큐에 쌓이고 공간을 차지합니다.

   이 문제를 해결하려면 다른 큐에서와 마찬가지로 배달 못 한 편지 큐에서 메시지를 읽고 완료합니다. FormatDeadLetterPath 메서드를 사용하여 배달 못한 편지 큐 경로의 서식을 지정할 수 있습니다.

2. 수신기 중지됨. 수신기가 큐 또는 구독에서 메시지 수신을 중지했습니다. 이를 식별하는 방법은 메시지의 전체 분석을 보여 주는 QueueDescription.MessageCountDetails 속성을 확인하는 것입니다. ActiveMessageCount 속성이 높거나 증가하는 경우 메시지는 작성되는 만큼 빠르게 읽지 않습니다.

타임아웃 예외

TimeoutException은 사용자가 시작한 작업이 작업 제한 시간보다 오래 걸리고 있음을 나타냅니다.

이 제한에 도달하면 TimeoutException이 발생할 수 있으므로 ServicePointManager.DefaultConnectionLimit 속성 값도 확인해야 합니다.

서비스를 실행하는 리소스에 대한 Service Bus 서비스 업데이트(또는) OS 업데이트와 같은 유지 관리 작업 중 또는 유지 관리 작업 사이에 시간 초과가 발생할 것으로 예상됩니다. OS 업데이트 중에 엔터티가 이동되고 노드가 업데이트되거나 다시 부팅되어 시간 초과가 발생할 수 있습니다. Azure Service Bus 서비스에 대한 SLA(서비스 수준 계약) 세부 정보는 Service Bus SLA를 참조하세요.

큐 및 토픽

큐 및 토픽의 경우 제한 시간은 MessagingFactorySettings.OperationTimeout 속성, 연결 문자열의 일부 또는 ServiceBusConnectionStringBuilder를 통해 지정됩니다. 오류 메시지 자체는 다를 수 있지만 현재 작업에 대해 지정된 제한 시간 값은 항상 포함됩니다.

메시지 잠금 손실 예외 (MessageLockLostException)

원인

클라이언트가 보유한 잠금이 서비스 쪽에서 만료될 때, PeekLock 수신 모드를 사용하여 메시지를 수신할 경우 MessageLockLostException이 발생합니다.

메시지 잠금은 다양한 이유로 만료될 수 있습니다.

• 클라이언트 애플리케이션에서 갱신하기 전에 잠금 타이머가 만료되었습니다.
• 클라이언트 애플리케이션이 잠금을 확보하고 영구 저장소에 저장한 다음, 다시 시작되었습니다. 다시 시작하자 클라이언트 애플리케이션은 전송 중인 메시지를 살펴보고 이를 완료하려고 했습니다.

다음 시나리오에서도 이 예외가 나타날 수 있습니다.

• 서비스 업데이트
• OS 업데이트
• 잠금을 보유하고 있는 동안 엔터티(큐, 토픽, 구독)의 속성 변경

해결 방법

클라이언트 애플리케이션이 MessageLockLostException을 수신하면 더 이상 메시지를 처리할 수 없습니다. 클라이언트 애플리케이션은 필요에 따라 분석을 위해 예외를 로깅하는 것을 고려할 수 있지만 클라이언트는 메시지를 삭제해야 합니다.

메시지에 대한 잠금이 만료되었으므로 메시지가 큐(또는 구독)로 돌아가고 receive를 호출하는 다음 클라이언트 애플리케이션에 의해 처리될 수 있습니다.

MaxDeliveryCount를 초과하면 메시지가 DeadLetterQueue로 이동될 수 있습니다.

세션 잠금 손실 예외

원인

세션이 수락되고 클라이언트가 보유한 잠금이 서비스 측에서 만료되면 SessionLockLostException이 던져집니다.

세션 잠금은 다양한 이유로 만료될 수 있습니다.

• 클라이언트 애플리케이션에서 갱신하기 전에 잠금 타이머가 만료되었습니다.
• 클라이언트 애플리케이션이 잠금을 확보하고 영구 저장소에 저장한 다음, 다시 시작되었습니다. 다시 시작된 후 클라이언트 애플리케이션이 Inflight 세션을 검토하고 해당 세션에서 메시지를 처리하려고 했습니다.

다음 시나리오에서도 이 예외가 나타날 수 있습니다.

• 서비스 업데이트
• OS 업데이트
• 잠금을 보유하고 있는 동안 엔터티(큐, 토픽, 구독)의 속성 변경

해결 방법

클라이언트 애플리케이션이 SessionLockLostException을 수신하면 더 이상 세션의 메시지를 처리할 수 없습니다. 클라이언트 애플리케이션은 분석을 위해 예외를 로깅하는 것을 고려할 수 있지만 클라이언트는 메시지를 삭제해야 합니다.

세션에 대한 잠금이 만료되었으므로 세션이 큐(또는 구독)로 돌아가고 세션을 호출하는 다음 클라이언트 애플리케이션에 의해 잠길 수 있습니다. 세션 잠금은 지정된 시간에 단일 클라이언트 애플리케이션이 확보하므로 순차적 처리가 보장됩니다.

소켓 예외

원인

SocketException은 다음과 같은 경우에 throw됩니다.

• 지정된 시간(TCP 오류 코드 10060) 후에 호스트가 제대로 응답하지 않아서 연결 시도가 실패한 경우
• 연결된 호스트가 응답하지 못해 연결을 설정하지 못했습니다.
• 메시지를 처리하는 동안 오류가 발생했거나 원격 호스트에서 제한 시간을 초과했습니다.
• 기본 네트워크 리소스 문제

해결 방법

SocketException 오류는 애플리케이션을 호스트하는 VM이 <mynamespace>.servicebus.windows.net이라는 이름을 해당 IP 주소로 변환할 수 없음을 의미합니다.

다음 명령이 IP 주소 매핑에 성공했는지 확인합니다.

PS C:\> nslookup <mynamespace>.servicebus.windows.net

다음과 같은 출력을 제공해야 합니다.

Name:    <cloudappinstance>.cloudapp.net
Address:  XX.XX.XXX.240
Aliases:  <mynamespace>.servicebus.windows.net

이름이 IP 및 네임스페이스 별칭으로 확인되지 않는 경우 네트워크 관리자에게 문의하여 자세히 조사합니다. 이름 확인은 일반적으로 고객 네트워크의 리소스인 DNS 서버를 통해 수행됩니다. Azure DNS에서 DNS 확인을 수행한 경우 Azure 지원에 문의하세요.

이름 확인이 예상대로 작동하는 경우 여기에서 Azure Service Bus에 대한 연결이 허용되는지 확인합니다.

메시징 예외

원인

MessagingException 은 다양한 이유로 throw될 수 있는 일반적인 예외입니다. 몇 가지 이유는 다음과 같습니다.

• 토픽 또는 구독에서 QueueClient를 만들려고 시도합니다.
• 보낸 메시지의 크기가 지정된 계층의 제한보다 큽합니다. Service Bus 할당량 및 제한에 대해 자세히 알아보세요.
• 제한으로 인해 특정 데이터 평면 요청(보내기, 수신, 완료, 중단)이 종료되었습니다.
• 서비스 업그레이드 및 다시 시작으로 인해 발생하는 일시적인 문제입니다.

해결 방법

MessagingException이 throw된 원인에 따라 해결 단계가 달라집니다.

• 일시적인 문제(isTransient가 true로 설정된 경우) 또는 제한 문제의 경우 작업을 다시 시도하면 문제가 해결될 수 있습니다. SDK의 기본 재시도 정책을 사용할 수 있습니다.
• 다른 문제의 경우 예외의 세부 정보는 문제 및 해결 단계를 동일한 방법으로 추론할 수 있음을 나타냅니다.

저장 한도 초과 예외

원인

Premium 네임스페이스에 있는 엔터티의 총 크기가 메시징 단위당 1TB 제한을 초과하면 StorageQuotaExceededException이 생성됩니다.

해결 방법

• 프리미엄 네임스페이스에 할당된 메시징 단위 수 늘리기
• 이미 네임스페이스에 허용되는 최대 메시징 단위를 사용하고 있는 경우 별도의 네임스페이스를 만듭니다.

다음 단계

전체 Service Bus .NET API 참조는 Azure .NET API 참조를 확인하세요. 문제 해결 팁은 문제 해결 가이드를 참조하세요.