Перейти к основному содержимому
Версия: 2.12

Системные ошибки

Все ошибки, не относящиеся к JetStream, которые сервер NATS может возвращать клиентам и соединениям маршрутов, шлюзов и листовых узлов.

Ошибки аутентификации и авторизации​

ОшибкаКонстантаОписание
Срок аутентификации истёкErrAuthExpiredСрок авторизации истёк из-за тайм-аута.
Прокси не является довереннымErrAuthProxyNotTrustedОшибка аутентификации: соединение поступило от прокси, не входящего в список доверенных.
Требуется соединение через проксиErrAuthProxyRequiredОшибка аутентификации: соединение поступило не через прокси.
Тайм-аут аутентификацииErrAuthTimeoutОшибка авторизации из-за истечения времени ожидания.
Ошибка аутентификацииErrAuthenticationОшибка аутентификации.
Учётные данные отозваныErrRevocationВозвращается при отзыве учётных данных.
Импорт сервиса не авторизованErrServiceImportAuthorizationВозвращается, если импорт сервиса не авторизован.
Импорт потока не авторизованErrStreamImportAuthorizationВозвращается, если импорт потока не авторизован.
Нарушение авторизацииAuthorization ViolationКлиент попытался выполнить операцию, нарушающую настроенные разрешения
Срок аутентификации пользователя истёкUser Authentication ExpiredСрок действия JWT или учётных данных пользователя истёк
Срок аутентификации аккаунта истёкAccount Authentication ExpiredСрок аутентификации аккаунта истёк
Аутентификация пользователя отозванаUser Authentication RevokedУчётные данные пользователя отозваны
Нарушение разрешения на публикациюPermissions Violation for PublishКлиент попытался опубликовать сообщение в субъект без разрешения
Нарушение разрешения на подпискуPermissions Violation for SubscriptionКлиент попытался подписаться на субъект без разрешения

Ошибки лимитов соединений​

ОшибкаКонстантаОписание
Превышен лимит активных соединений аккаунтаErrTooManyAccountConnectionsАккаунт достиг максимального числа активных соединений.
Превышен лимит соединенийErrTooManyConnectionsДостигнуто максимальное число поддерживаемых сервером соединений.
Превышен лимит подписокErrTooManySubsДостигнуто максимальное число подписок на соединение.
Действует ограничение частоты соединенийConnection Throttling Is ActiveСервер ограничивает частоту новых соединений
Превышен лимит клиентовMaximum Clients ExceededСервер достиг максимального допустимого числа клиентов

Ошибки протокола и полезной нагрузки​

ОшибкаКонстантаОписание
Недопустимый клиентский протоколErrBadClientProtocolКлиент запросил недопустимый клиентский протокол.
Обнаружен некорректный заголовок сообщенияErrBadMsgHeaderАнализатор обнаружил некорректный заголовок сообщения
Превышена длина строки управленияErrMaxControlLineСлишком длинная строка управления.
Превышен размер полезной нагрузкиErrMaxPayloadСлишком большая полезная нагрузка.
Заголовки сообщений не поддерживаютсяErrMsgHeadersNotSupportedАнализатор обнаружил заголовок сообщения, но этот сервер не поддерживает заголовки.
Уведомление об отсутствии обработчиков требует поддержки заголовковErrNoRespondersRequiresHeadersКлиенту нужно включить заголовки для получения уведомлений об отсутствии обработчиков.
Нарушен лимит полезной нагрузкиMaximum Payload ViolationОпубликованное сообщение превышает настроенный максимальный размер полезной нагрузки
Нарушение протоколаProtocol ViolationКлиент нарушил протокол NATS
Ошибка синтаксического анализатораParser ErrorСервер обнаружил ошибку разбора клиентского протокола

Ошибки субъектов и публикации​

ОшибкаКонстантаОписание
Недопустимый субъект публикацииErrBadPublishSubjectНедопустимый субъект публикации.
Неверный квалификаторErrBadQualifierОшибка неверного квалификатора преобразования.
Недопустимый субъектErrBadSubjectНедопустимый субъект.
Недопустимое назначение отображенияErrInvalidMappingDestinationИспользуется для всех ошибок назначения отображения субъектов
Недопустимое преобразованиеErrInvalidMappingDestinationSubjectОшибка неверного отображения назначения преобразования
Некорректный субъектErrMalformedSubjectВозвращается при подписке на субъект, не соответствующий правилам субъектов.
Индекс подстановки вне диапазонаErrMappingDestinationIndexOutOfRangeВозвращается, если аргумент функции назначения отображения содержит индекс подстановки вне допустимого диапазона
Аргумент функции недопустим или имеет неверный форматErrMappingDestinationInvalidArgВозвращается, если функции назначения отображения передан недопустимый аргумент
Функции передано недостаточно аргументовErrMappingDestinationNotEnoughArgsВозвращается, если функции назначения отображения передано недостаточно аргументов
Единственная функция отображения, разрешённая для преобразований импорта, — {{Wildcard()}}ErrMappingDestinationNotSupportedForImportВозвращается при попытке использовать функцию отображения, отличную от подстановки, в преобразовании, которое должно быть обратимым (например, в импорте)
Используются не все подстановки токеновErrMappingDestinationNotUsingAllWildcardsОшибка назначения преобразования, в котором используются не все подстановки токенов
Функции передано слишком много аргументовErrMappingDestinationTooManyArgsВозвращается, если функции назначения отображения передано слишком много аргументов
Нет подходящих преобразованийErrNoTransformsНет преобразований субъектов для отображения этого субъекта.
Зарезервированный аккаунтErrReservedAccountЗарезервированный аккаунт, который нельзя создать.
Зарезервированный внутренний субъектErrReservedPublishSubjectОтправка в зарезервированный субъект, например _SYS.>.
Превышен лимит числа токенов субъектаErrTooManySubTokensВ субъекте клиента слишком много токенов.
Неизвестная функцияErrUnknownMappingDestinationFunctionВозвращается, если назначение отображения субъекта содержит неизвестную функцию отображения в фигурных скобках.
Недопустимая подпискаInvalid SubscriptionНедопустимый запрос подписки

Ошибки TLS и безопасности​

ОшибкаКонстантаОписание
Сертификат не закреплёнErrCertNotPinnedВозвращается, если список закреплённых сертификатов задан, но сертификат в него не входит
Защищённое соединение: требуется TLSSecure Connection - TLS RequiredСервер требует TLS, но клиент попытался подключиться без TLS
Ошибка рукопожатия TLSTLS Handshake ErrorРукопожатие TLS с клиентом не удалось

Ошибки аккаунтов​

ОшибкаКонстантаОписание
Аккаунт существуетErrAccountExistsВозвращается при попытке регистрации уже существующего аккаунта.
Срок действия аккаунта истёкErrAccountExpiredВозвращается, если срок действия аккаунта истёк.
В резолвере аккаунтов нет новых утвержденийErrAccountResolverSameClaimsВозвращается при получении тех же утверждений.
Слишком частое обновление резолвера аккаунтовErrAccountResolverUpdateTooSoonВозвращается при попытке обновления слишком скоро после предыдущего запроса.
Проверка аккаунта не пройденаErrAccountValidationВозвращается, если аккаунт не прошёл проверку.
Неверный аккаунтErrBadAccountНекорректный или недопустимый аккаунт.
Неверный процент выборки: требуется 1–100ErrBadSamplingВозвращается, если доля выборки для отслеживания задержки не удовлетворяет условию 1 >= sample <= 100.
Неверный тип ответа сервисаErrBadServiceTypeВозвращается при применении отслеживания задержки к типам ответов, не являющимся одиночными.
Импорт образует циклErrImportFormsCycleВозвращается, если импорт образовал бы цикл.
Аккаунт отсутствуетErrMissingAccountВозвращается, если аккаунт не существует.
Сервис отсутствуетErrMissingServiceВозвращается, если у аккаунта нет экспортированного сервиса.
Резолвер аккаунтов отсутствуетErrNoAccountResolverВозвращается при попытке обновления без резолвера аккаунтов.
Системный аккаунт не настроенErrNoSysAccountВозвращается при попытке публикации или подписки, если внутренний системный аккаунт не задан.
Префикс импорта потока не может содержать токены подстановкиErrStreamImportBadPrefixВозвращается, если префикс импорта потока содержит подстановки.
Импорт потока уже существуетErrStreamImportDuplicateВозвращается, если импорт потока дублирует существующий.
Ошибка регистрации аккаунтаFailed Account RegistrationНе удалось зарегистрировать клиента в аккаунте

Ошибки имён серверов и кластеров​

ОшибкаКонстантаОписание
Конфликт имён кластера в определениях cluster и gatewayErrClusterNameConfigConflictНастройки имени кластера в cluster и gateway конфликтуют.
Имя кластера не может содержать пробелыErrClusterNameHasSpacesИмя кластера содержит недопустимые пробелы.
Имя кластера удалённого сервера конфликтует с локальнымErrClusterNameRemoteConflictУдалённый сервер имеет другое имя кластера.
Повторяющееся имя сервераErrDuplicateServerNameВозвращается при обработке удалённого серверного соединения, если сервер сообщает, что имя этого сервера уже используется в кластере.
Имя шлюза не может содержать пробелыErrGatewayNameHasSpacesИмя шлюза содержит недопустимые пробелы.
Удалённый листовой узел имеет то же имя кластераErrLeafNodeHasSameClusterNameЛистовой узел является кластером и имеет то же имя кластера, что и центральный кластер.
Имя сервера не может содержать пробелыErrServerNameHasSpacesИмя сервера содержит недопустимые пробелы.

Ошибки подключения к неверному порту​

ОшибкаКонстантаОписание
Попытка подключения к порту листовых узловErrClientConnectedToLeafNodePortКлиент попытался подключиться к порту приёма соединений листовых узлов.
Попытка подключения к порту маршрутовErrClientConnectedToRoutePortКлиент попытался подключиться к порту приёма маршрутных соединений.
Попытка подключения к порту шлюзаErrClientOrRouteConnectedToGatewayPortКлиент или маршрут попытался подключиться к порту шлюза.
Попытка подключения к неверному портуErrConnectedToWrongPortПопытка подключения к неверному порту (например, листового узла к клиентскому порту).

Ошибки шлюзов​

ОшибкаКонстантаОписание
Неверный шлюзErrWrongGatewayСервер получил запрос подключения от удалённого шлюза с именем назначения, не совпадающим с именем шлюза этого сервера.
Соединение со шлюзом отклоненоConnection to Gateway RejectedШлюз отклонил соединение

Ошибки листовых узлов​

ОшибкаКонстантаОписание
Листовые узлы отключеныErrLeafNodeDisabledЛистовые узлы отключены.
Обнаружен цикл листовых узловErrLeafNodeLoopЛистовой узел пытается зарегистрироваться для кластера, который уже зарегистрирован.

Ошибки состояния соединений​

ОшибкаКонстантаОписание
Соединение закрытоErrConnectionClosedОперация с закрытым соединением.
Сервер не работаетErrServerNotRunningСообщает об ошибке: сервер не работает.
Устаревшее соединениеStale ConnectionСоединение устарело и будет закрыто

Другие ошибки​

ОшибкаКонстантаОписание
Исчерпана глубина поиска цикловErrCycleSearchDepthВозвращается при превышении максимальной глубины поиска.
Требуется минимальная версияErrMinimumVersionRequiredВозвращается, если соединение не соответствует минимальной требуемой версии.
Нарушение разрешения на подпискуErrSubscribePermissionViolationВозвращается при отказе в обработке подписки из-за разрешений.

Ошибки маршрутов​

ОшибкаКонстантаОписание
Нарушение авторизации маршрутаRoute Authorization ViolationМаршрутное соединение не прошло авторизацию
Повторный маршрутDuplicate RouteМаршрутное соединение с этим сервером уже существует

Медленные потребители и управление потоком​

ОшибкаКонстантаОписание
Обнаружен медленный потребительSlow Consumer DetectedСервер обнаружил медленного потребителя, не успевающего принимать сообщения
Медленный потребительConsumer Is SlowПотребитель обрабатывает сообщения слишком медленно
Превышен срок записиWrite Deadline ExceededЗапись клиенту превысила настроенный срок ожидания

Причины закрытия соединений​

Причины, по которым сервер может закрыть клиентское соединение. Они отображаются в данных мониторинга и событиях отключения.

ОшибкаКонстантаОписание
Закрыто клиентомClientClosedЗакрыто клиентом
Тайм-аут аутентификацииAuthenticationTimeoutТайм-аут аутентификации
Ошибка аутентификацииAuthenticationViolationОшибка аутентификации
Сбой рукопожатия TLSTLSHandshakeErrorСбой рукопожатия TLS
Медленный потребитель (ожидающие байты)SlowConsumerPendingBytesМедленный потребитель (ожидающие байты)
Медленный потребитель (срок записи)SlowConsumerWriteDeadlineМедленный потребитель (срок записи)
Ошибка записиWriteErrorОшибка записи
Ошибка чтенияReadErrorОшибка чтения
Ошибка разбораParseErrorОшибка разбора
Устаревшее соединениеStaleConnectionУстаревшее соединение
Нарушение протоколаProtocolViolationНарушение протокола
Неверная версия клиентского протоколаBadClientProtocolVersionНеверная версия клиентского протокола
Неверный портWrongPortНеверный порт
Превышен лимит соединений аккаунтаMaxAccountConnectionsExceededПревышен лимит соединений аккаунта
Превышен лимит соединенийMaxConnectionsExceededПревышен лимит соединений
Превышен размер полезной нагрузки сообщенияMaxPayloadExceededПревышен размер полезной нагрузки сообщения
Превышена длина строки управленияMaxControlLineExceededПревышена длина строки управления
Превышен лимит подписокMaxSubscriptionsExceededПревышен лимит подписок
Повторный маршрутDuplicateRouteПовторный маршрут
Маршрут удалёнRouteRemovedМаршрут удалён
Завершение работы сервераServerShutdownЗавершение работы сервера
Срок аутентификации истёкAuthenticationExpiredСрок аутентификации истёк
Неверный шлюзWrongGatewayНеверный шлюз
Аккаунт отсутствуетMissingAccountАккаунт отсутствует
Учётные данные отозваныRevocationУчётные данные отозваны
Внутренний клиентInternalClientВнутренний клиент
Нарушение формата заголовка сообщенияMsgHeaderViolationНарушение формата заголовка сообщения
Для уведомления об отсутствии обработчиков нужны заголовкиNoRespondersRequiresHeadersДля уведомления об отсутствии обработчиков нужны заголовки
Конфликт имён кластеровClusterNameConflictКонфликт имён кластеров
Повторное соединение удалённого листового узлаDuplicateRemoteLeafnodeConnectionПовторное соединение удалённого листового узла
Повторяющийся идентификатор клиентаDuplicateClientIDПовторяющийся идентификатор клиента
Повторяющееся имя сервераDuplicateServerNameПовторяющееся имя сервера
Требуется минимальная версияMinimumVersionRequiredТребуется минимальная версия
Имена кластеров совпадаютClusterNamesIdenticalИмена кластеров совпадают
Принудительно отключеноKickedПринудительно отключено
Недоверенный проксиProxyNotTrustedНедоверенный прокси
Требуется проксиProxyRequiredТребуется прокси