Ошибки · Решение
gRPC 2 UNKNOWN: что означает и как исправить
Получена неизвестная ошибка, которую gRPC не смог отнести к более точному статусу.
Короткий ответ
gRPC status 2 UNKNOWN. Получена неизвестная ошибка, которую gRPC не смог отнести к более точному статусу. Сверьте код с официальной поддержкой производителя и выполните только безопасные шаги.
Что означает ошибка
Получена неизвестная ошибка, которую gRPC не смог отнести к более точному статусу.
Возможные причины
- Сервер завершился исключением без корректного status mapping.
- Ошибка пришла из другой error domain и была преобразована в UNKNOWN.
- Middleware потерял исходные детали ошибки при сериализации статуса.
Что проверить
- Проверьте server logs по trace-id и найдите исходное исключение.
- Сравните direct server call и вызов через proxy/interceptor.
- Посмотрите status message/details до преобразования на границе сервиса.
Безопасные шаги
- Добавьте явное mapping ожидаемых ошибок на подходящие gRPC statuses.
- Исправьте middleware, которое стирает оригинальный status.
- Не используйте UNKNOWN как штатный ответ для известных бизнес-ошибок.
Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.
Когда нужен сервис
- Если UNKNOWN возникает только через один gateway, передайте raw gRPC status/trailers и trace-id владельцу этого gateway.
Похожие ошибки
- /errors/grpc-status-cancelled/
- /errors/grpc-status-invalid-argument/
- /errors/grpc-status-deadline-exceeded/
Что учитывать
Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.
Официальный источник
Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.