gRPC 5 NOT_FOUND: что означает и как исправить

Что означает ошибка

Запрошенная сущность не найдена; gRPC также допускает NOT_FOUND для скрытия целого класса ресурсов.

Возможные причины

• ID ресурса не существует.
• Ресурс удалён между чтением и обращением.
• Сервис намеренно скрывает недоступный класс ресурсов этим статусом.

Что проверить

• Проверьте canonical ID и scope/tenant запроса.
• Сделайте lookup через тот же service version.
• Отделите отсутствие объекта от permission policy по серверным логам.

Безопасные шаги

1. Исправьте идентификатор или создайте ресурс штатным workflow.
2. Обрабатывайте удалённый ресурс идемпотентно, если операция это допускает.
3. Не заменяйте NOT_FOUND на PERMISSION_DENIED без учёта политики раскрытия ресурсов.

Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.

Когда нужен сервис

• Если объект виден в хранилище, но API возвращает NOT_FOUND, приложите resource-id, tenant и trace-id владельцу сервиса.

Похожие ошибки

• /errors/grpc-status-cancelled/
• /errors/grpc-status-unknown/
• /errors/grpc-status-invalid-argument/

Что учитывать

Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.

Официальный источник

Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.

• gRPC Status Codes — 5 NOT_FOUND