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

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

Сущность, которую клиент пытается создать, уже существует.

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

• Повторный create использует тот же уникальный ID.
• Две параллельные операции создают один ресурс.
• Идемпотентность клиента не учитывает результат предыдущей попытки.

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

• Проверьте существование ресурса по canonical key.
• Сопоставьте parallel create traces.
• Посмотрите idempotency key/request token, если API его поддерживает.

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

1. Перейдите к update/get существующей сущности, если это ожидаемый сценарий.
2. Используйте idempotency mechanism API.
3. Не удаляйте существующий объект автоматически только ради повторного create.

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

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

• Если ресурс фактически отсутствует, а ALREADY_EXISTS сохраняется, передайте unique key и storage index evidence владельцу backend.

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

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

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

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

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

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

• gRPC Status Codes — 6 ALREADY_EXISTS