Системные ошибки
Все ошибки, не относящиеся к 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 | Недопустимый субъект. |
| Имя кластера зарезервировано | ErrClusterNameReserved | Имя кластера зарезервировано для внутреннего использования протоколом. |
| Недопустимое назначение отображения | ErrInvalidMappingDestination | Используется для всех ошибок назначения отображения субъектов |
| Недопустимое преобразование | ErrInvalidMappingDestinationSubject | Ошибка неверного отображения назначения преобразования |
| Некорректный субъект | ErrMalformedSubject | Возвращается при подписке на субъект, не соответствующий правилам субъектов. |
| Индекс подстановки вне диапазона | ErrMappingDestinationIndexOutOfRange | Возвращается, если аргумент функции назначения отображения содержит индекс подстановки вне допустимого диапазона |
| Аргумент функции недопустим или имеет неверный формат | ErrMappingDestinationInvalidArg | Возвращается, если функции назначения отображения передан недопустимый аргумент |
| Функции передано недостаточно аргументов | ErrMappingDestinationNotEnoughArgs | Возвращается, если функции назначения отображения передано недостаточно аргументов |
Единственная функция отображения, разрешённая для преобразований импорта, — {{Wildcard()}} | ErrMappingDestinationNotSupportedForImport | Возвращается при попытке использовать функцию отображения, отличную от подстановки, в преобразовании, которое должно быть обратимым (например, в импорте) |
| Используются не все подстановки токенов | ErrMappingDestinationNotUsingAllWildcards | Ошибка назначения преобразования, в котором используются не все подстановки токенов |
| Функции передано слишком много аргументов | ErrMappingDestinationTooManyArgs | Возвращается, если функции назначения отображения передано слишком много аргументов |
| Нет подходящих преобразований | ErrNoTransforms | Нет преобразований субъектов для отображения этого субъекта. |
| Зарезервированный аккаунт | ErrReservedAccount | Зарезервированный аккаунт, который нельзя создать. |
| Зарезервированный внутренний субъект | ErrReservedPublishSubject | Отправка в зарезервированный субъект, например _SYS.>. |
| Превышен лимит числа токенов субъекта | ErrTooManySubTokens | В субъекте клиента слишком много токенов. |
| Неизвестная функция | ErrUnknownMappingDestinationFunction | Возвращается, если назначение отображения субъекта содержит неизвестную функцию отображения в фигурных скобках. |
| Недопустимая подписка | Invalid Subscription | Недопустимый запрос подписки |
Ошибки TLS и безопасности
| Ошибка | Константа | Описание |
|---|---|---|
| Сертификат не закреплён | ErrCertNotPinned | Возвращается, если список закреплённых сертификатов задан, но сертификат в него не входит |
| Защищённое соединение: требуется TLS | Secure Connection - TLS Required | Сервер требует TLS, но клиент попытался подключиться без TLS |
| Ошибка рукопожатия TLS | TLS Handshake Error | Рукопожатие TLS с клиентом не удалось |
Ошибки аккаунтов
| Ошибка | Константа | Описание |
|---|---|---|
| Аккаунт существует | ErrAccountExists | Возвращается при попытке регистрации уже существующего аккаунта. |
| Срок действия аккаунта истёк | ErrAccountExpired | Возвращается, если срок действия аккаунта истёк. |
| В резолвере аккаунтов нет новых утверждений | ErrAccountResolverSameClaims | Возвращается при получении тех же утверждений. |
| Слишком частое обновление резолвера аккаунтов | ErrAccountResolverUpdateTooSoon | Возвращается при попытке обновления слишком скоро после предыдущего запроса. |
| Проверка аккаунта не пройдена | ErrAccountValidation | Возвращается, если аккаунт не прошёл проверку. |
| Неверный аккаунт | ErrBadAccount | Некорректный или недопустимый аккаунт. |
| Неверный процент выборки: требуется 1–100 | ErrBadSampling | Возвращается, если доля выборки для отслеживания задержки не удовлетворяет условию 1 >= sample <= 100. |
| Неверный тип ответа сервиса | ErrBadServiceType | Возвращается при применении отслеживания задержки к типам ответов, не являющимся одиночными. |
| Импорт образует цикл | ErrImportFormsCycle | Возвращается, если импорт образовал бы цикл. |
| Аккаунт отсутствует | ErrMissingAccount | Возвращается, если аккаунт не существует. |
| Сервис отсутствует | ErrMissingService | Возвращается, если у аккаунта нет экспортированного сервиса. |
| Резолвер аккаунтов отсутствует | ErrNoAccountResolver | Возвращается при попытке обновления без резолвера аккаунтов. |
| Системный аккаунт не настроен | ErrNoSysAccount | Возвращается при попытке публикации или подписки, если внутренний системный аккаунт не задан. |
| Префикс импорта потока не может содержать токены подстановки | ErrStreamImportBadPrefix | Возвращается, если префикс импорта потока содержит подстановки. |
| Импорт потока уже существует | ErrStreamImportDuplicate | Возвращается, если импорт потока дублирует существующий. |
| Ошибка регистрации аккаунта | Failed Account Registration | Не удалось зарегистрировать клиента в аккаунте |
Ошибки имён серверов и кластеров
| Ошибка | Константа | Описание |
|---|---|---|
| Конфликт имён кластера в определениях cluster и gateway | ErrClusterNameConfigConflict | Настройки имени кластера в cluster и gateway конфликтуют. |
| Имя кластера не может содержать пробелы | ErrClusterNameHasSpaces | Имя кластера содержит недопустимые пробелы. |
| Имя кластера удалённого сервера конфликтует с локальным | ErrClusterNameRemoteConflict | Удалённый сервер имеет другое имя кластера. |
| Повторяющееся имя сервера | ErrDuplicateServerName | Возвращается при обработке удалённого серверного соединения, если сервер сообщает, что имя этого сервера уже используется в кластере. |
| Имя шлюза не может содержать пробелы | ErrGatewayNameHasSpaces | Имя шлюза содержит недопустимые пробелы. |
| Удалённый листовой узел имеет то же имя кластера | ErrLeafNodeHasSameClusterName | Листовой узел является кластером и имеет то же имя кластера, что и центральный кластер. |
| Имя сервера не может содержать пробелы | ErrServerNameHasSpaces | Имя сервера содержит недопустимые пробелы. |
Ошибки подключения к неверному порту
| Ошибка | Константа | Описание |
|---|---|---|
| Попытка подключения к порту листовых узлов | ErrClientConnectedToLeafNodePort | Клиент попытался подключиться к порту приёма соединений листовых узлов. |
| Попытка подключения к порту маршрутов | ErrClientConnectedToRoutePort | Клиент попытался подключиться к порту приёма маршрутных соединений. |
| Попытка подключения к порту шлюза | ErrClientOrRouteConnectedToGatewayPort | Клиент или маршрут попытался подключиться к порту шлюза. |
| Попытка подключения к неверному порту | ErrConnectedToWrongPort | Попытка подключения к неверному порту (например, листового узла к клиентскому порту). |
Ошибки шлюзов
| Ошибка | Константа | Описание |
|---|---|---|
| Неверный шлюз | ErrWrongGateway | Сервер получил запрос подключения от удалённого шлюза с именем назначения, не совпадающим с именем шлюза этого сервера. |
| Соединение со шлюзом отклонено | Connection to Gateway Rejected | Шлюз отклонил соединение |
Ошибки листовых узлов
| Ошибка | Константа | Описание |
|---|---|---|
| Листовые узлы отключены | ErrLeafNodeDisabled | Листовые узлы отключены. |
| Обнаружен цикл листовых узлов | ErrLeafNodeLoop | Листовой узел пытается зарегистрироваться для кластера, который уже зарегистрирован. |
| Соединение отклонено: требуется минимальная версия | ErrLeafNodeMinVersionRejected | Префикс ошибки протокола листового узла при отклонении удалённого узла из-за leafnodes.min_version. |
Ошибки состояния соединений
| Ошибка | Константа | Описание |
|---|---|---|
| Соединение закрыто | ErrConnectionClosed | Операция с закрытым соединением. |
| Сервер не работает | ErrServerNotRunning | Сообщает об ошибке: сервер не работает. |
| Устаревшее соединение | Stale Connection | Соединение устарело и будет закрыто |
Другие ошибки
| Ошибка | Константа | Описание |
|---|---|---|
| Исчерпана глубина поиска циклов | ErrCycleSearchDepth | Возвращается при превышении максимальной глубины поиска. |
| Требуется минимальная версия | ErrMinimumVersionRequired | Возвращается, если соединение не соответствует минимальной требуемой версии. |
| Нарушение разрешения на подписку | ErrSubscribePermissionViolation | Возвращается при отказе в обработке подписки из-за разрешений. |
Ошибки маршрутов
| Ошибка | Константа | Описание |
|---|---|---|
| Нарушение авторизации маршрута | Route Authorization Violation | Маршрутное соединение не прошло авторизацию |
| Повторный маршрут | Duplicate Route | Маршрутное соединение с этим сервером уже существует |
Медленные потребители и управление потоком
| Ошибка | Константа | Описание |
|---|---|---|
| Обнаружен медленный потребитель | Slow Consumer Detected | Сервер обнаружил медленного потребителя, не успевающего принимать сообщения |
| Медленный потребитель | Consumer Is Slow | Потребитель обрабатывает сообщения слишком медленно |
| Превышен срок записи | Write Deadline Exceeded | Запись клиенту превысила настроенный срок ожидания |
Причины закрытия соединений
Причины, по которым сервер может закрыть клиентское соединение. Они отображаются в данных мониторинга и событиях отключения.
| Ошибка | Константа | Описание |
|---|---|---|
| Закрыто клиентом | ClientClosed | Закрыто клиентом |
| Тайм-аут аутентификации | AuthenticationTimeout | Тайм-аут аутентификации |
| Ошибка аутентификации | AuthenticationViolation | Ошибка аутентификации |
| Сбой рукопожатия TLS | TLSHandshakeError | Сбой рукопожатия 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 | Требуется прокси |