Ошибка invalid request error description sdk package is incorrect появляется в момент, когда приложение или сервис пытается обратиться к внешнему SDK, а сервер отклоняет запрос, потому что идентификатор пакета, подпись или конфигурация SDK не совпадают с тем, что зарегистрировано у провайдера. Симптом одинаковый: интеграция отказывается работать, а в логах или в диалоговом окне виден именно этот текст отказа.
Чаще всего с этим сообщением сталкиваются разработчики при подключении SDK авторизации, аналитики, рекламы или платёжных модулей, а также обычные пользователи — когда приложение с некорректно собранным пакетом попадает на устройство. Ниже разберём, что означает ошибка, где искать причину и какие проверки помогают её устранить без риска для проекта.
Что означает сообщение «sdk package is incorrect»
Текст ошибки состоит из трёх частей: invalid request говорит о том, что запрос отклонён, error description — это поле с пояснением, а sdk package is incorrect указывает на конкретную причину: пакет SDK не прошёл проверку на стороне сервера. Под «пакетом» обычно понимается имя пакета приложения (например, applicationId в Android), версия библиотеки SDK или связка этих данных с цифровой подписью.
Сервер провайдера SDK при регистрации приложения сохраняет эталонные значения: имя пакета, отпечаток сертификата подписи, иногда хэш ключа. Если при обращении хотя бы одно значение не совпадает, запрос считается недействительным, и вместо данных возвращается отказ. Это защитный механизм, который не даёт чужим приложениям использовать ваш ключ SDK.
Основные причины возникновения ошибки
Причина почти всегда лежит в несоответствии между тем, что указано в консоли провайдера SDK, и тем, что реально содержится в сборке приложения. Типичные сценарии выглядят так:
- 🔧 Имя пакета в консоли разработчика не совпадает с
applicationIdв файле сборки приложения. - 🔐 Приложение подписано другим сертификатом: например, отладочным вместо релизного, поэтому отпечаток не совпадает с зарегистрированным.
- 📦 Используется устаревшая или несовместимая версия самого SDK, которую сервер больше не принимает.
- ⚙️ Ключ API или идентификатор приложения скопирован с ошибкой, либо взят из другого проекта.
- 🧪 Проверка выполняется на тестовой сборке, которая не добавлена в список разрешённых в консоли провайдера.
Отдельный сценарий — сторонние сборки и модифицированные приложения. Если приложение переупаковано или подписано заново, его подпись гарантированно отличается от оригинальной, и сервер SDK отклонит запрос. В таком случае ошибка является ожидаемым поведением защиты, а не сбоем.
⚠️ Внимание: если ошибка возникает в приложении, установленном не из официального магазина, возможная причина — модифицированная сборка с изменённой подписью. Устанавливать такие пакеты рискованно: помимо неработающих функций они могут содержать вредоносный код.
Быстрая диагностика: с чего начать проверку
Прежде чем менять конфигурацию, стоит зафиксировать исходные данные. Вам нужно узнать три значения: фактическое имя пакета приложения, отпечаток сертификата, которым оно подписано, и версию подключённого SDK. Все три сверяются с тем, что указано в консоли провайдера.
Имя пакета в Android-проекте задаётся параметром applicationId в файле build.gradle уровня модуля приложения. Отпечаток сертификата для подписи можно получить из хранилища ключей командой keytool, если у вас есть доступ к keystore проекта. Точный синтаксис зависит от версии инструментов, поэтому сверяйтесь с документацией вашего окружения сборки.
☑️ Проверка перед исправлением ошибки
Если вы не разработчик, а пользователь приложения, диагностика сводится к другому: проверьте, установлена ли последняя версия приложения из официального источника, и не используется ли модифицированная сборка. Обновление или переустановка из официального магазина часто решает проблему без дополнительных действий.
Исправление на стороне разработчика
Последовательность действий зависит от того, какое именно значение не совпало. Начинайте с самого простого — имени пакета, и двигайтесь дальше по списку.
Шаг 1. Откройте консоль провайдера SDK и найдите раздел с настройками вашего приложения. Сравните зарегистрированное имя пакета с applicationId в проекте. Регистр символов имеет значение: имена пакетов чувствительны к нему. Если значения различаются, либо поправьте настройку в консоли, либо приведите проект к зарегистрированному имени.
Шаг 2. Проверьте подпись. Отладочные сборки подписываются автоматически сгенерированным debug-сертификатом, а релизные — вашим ключом. Если в консоли зарегистрирован только релизный отпечаток, отладочная сборка будет отклоняться. Добавьте отпечаток отладочного сертификата в консоль, если провайдер это позволяет, либо тестируйте на релизной подписи.
Шаг 3. Обновите SDK до актуальной версии, рекомендованной провайдером. Устаревшие версии могут отклоняться сервером, особенно если формат запроса изменился. После обновления пересоберите проект и очистите кэш сборки, чтобы исключить остатки старой библиотеки.
./gradlew clean assembleReleaseШаг 4. Перепроверьте ключи. Скопируйте ключ API или идентификатор приложения из консоли заново, не полагаясь на старые записи: лишний пробел или символ из другого проекта — частая причина отказа. Ключи обычно хранятся в конфигурационном файле или в ресурсах приложения, место зависит от конкретного SDK.
Что делать, если вы пользователь, а не разработчик
Когда ошибка появляется в готовом приложении на вашем устройстве, исправить конфигурацию SDK самостоятельно нельзя — это зона ответственности разработчика. Но несколько безопасных действий доступны и вам.
- 🔄 Обновите приложение через официальный магазин: разработчик мог уже выпустить исправление.
- 🧹 Очистите кэш приложения в настройках устройства и запустите его заново — иногда помогает при сбоях после обновления.
- 🗑️ Удалите приложение и установите его заново только из официального источника.
- 📩 Сообщите о проблеме разработчику через страницу приложения в магазине, указав текст ошибки и модель устройства.
Если приложение устанавливалось не из официального магазина, наиболее вероятное объяснение — изменённая подпись пакета. В этом случае корректный выход один: удалить такую сборку и поставить оригинальную версию.
⚠️ Внимание: не пытайтесь «обойти» проверку SDK патчами или инструментами подмены подписи. Это нарушает условия использования сервиса, а на устройстве создаёт серьёзные риски безопасности.
Типичные сценарии и их отличия
Чтобы быстрее определить свой случай, сверьтесь с таблицей: в ней собраны частые ситуации и направление проверки для каждой.
| Ситуация | Вероятная причина | Что проверить |
|---|---|---|
| Ошибка только в debug-сборке | Отладочный отпечаток не зарегистрирован | Добавить debug-сертификат в консоль SDK |
| Ошибка после обновления приложения | Изменилась подпись или имя пакета | Сверить applicationId и сертификат с консолью |
| Ошибка у всех пользователей релиза | Неверный ключ API или устаревший SDK | Перевыпустить ключ, обновить библиотеку |
| Ошибка в сторонней сборке | Переупакованное приложение с другой подписью | Установить оригинал из официального магазина |
| Ошибка после переноса проекта | Ключи взяты из старого проекта | Проверить соответствие ключей текущему приложению |
Обратите внимание: точные названия разделов консоли и формат отпечатков различаются у разных провайдеров SDK. Ориентируйтесь на официальную документацию конкретного сервиса, а не на универсальные инструкции.
Почему сервер вообще проверяет пакет и подпись
SDK-провайдеры привязывают ключ к конкретному приложению, чтобы ключ нельзя было украсть и использовать в чужом продукте. Проверка имени пакета и отпечатка сертификата — стандартный способ убедиться, что запрос пришёл именно от зарегистрированного приложения, а не от подделки. Поэтому ошибка «sdk package is incorrect» — это срабатывание защиты, а не случайный сбой.
Как предотвратить ошибку в будущем
Большинство случаев связано с рассинхронизацией между проектом и консолью провайдера. Дисциплина в управлении конфигурацией снимает почти все риски. Храните отпечатки сертификатов обеих сборок в документации проекта и обновляйте записи в консоли сразу после смены ключа подписи.
Полезно также автоматизировать проверку: добавьте в процесс сборки шаг, который выводит applicationId и отпечаток подписи текущей сборки. Тогда несовпадение видно ещё до публикации, а не после жалоб пользователей. И наконец, подписывайтесь на уведомления провайдера SDK об устаревании версий — своевременное обновление библиотеки исключает отказы со стороны сервера.
Часто задаваемые вопросы
Может ли ошибка «sdk package is incorrect» исчезнуть сама?
Если причина на стороне сервера провайдера (временный сбой), ошибка может пропасть без действий. Но если несовпадают пакет, подпись или ключ, само по себе ничего не изменится — требуется исправление конфигурации.
Ошибка появилась после обновления приложения. Кто виноват?
Скорее всего, в новой версии изменилось имя пакета, подпись или версия SDK, а настройки в консоли провайдера не обновили. Это исправляет разработчик: как пользователь вы можете только сообщить о проблеме и дождаться обновления.
Отличается ли отладочная подпись от релизной?
Да. Отладочные сборки подписываются автоматически созданным debug-сертификатом, релизные — вашим ключом разработчика. Их отпечатки разные, поэтому в консоли SDK часто нужно регистрировать оба.
Опасно ли использовать приложение с такой ошибкой?
Сама ошибка не вредит устройству — просто часть функций, зависящих от SDK, не работает. Риск представляет другое: если ошибка вызвана модифицированной сборкой из неофициального источника, такое приложение лучше удалить.
Где найти точную инструкцию по настройке моего SDK?
Только в официальной документации провайдера SDK, который вы подключаете. Названия разделов консоли, формат отпечатков и способы регистрации пакета у разных сервисов отличаются, и универсальной инструкции здесь нет.