Фраза «не работает отпечаток» скрывает несколько разных сбоев. Системное окно может вообще не открыться, может вернуть ошибку, может подтвердить палец, но не разблокировать ключ, либо приложение получит ключ и упадёт на обновлении серверной сессии. Лечить эти случаи повторной регистрацией отпечатка вслепую не стоит.

Проведите тест обновления со старой production-версии, а не только чистую установку новой. Сохраните обезличенно три результата: код `BiometricPrompt`, возможность выполнить криптографическую операцию и ответ backend. Первое расхождение покажет реальный слой проблемы.

Что видит пользователь — и что это обычно означает

НаблюдениеВероятный слойСледующая проверка
Системное окно не появляетсяLifecycle, Fragment или allowedAuthenticatorsЛог до вызова authenticate и canAuthenticate
Палец принят, затем ошибкаKeystore или CryptoObjectИсключение при init/doFinal
Биометрия успешна, но снова экран входаТокен или backend-сессияОтвет refresh/exchange endpoint
Работает после переустановкиМиграция локального состоянияСравнить данные старой и чистой установки

Проверьте жизненный цикл BiometricPrompt

После обновления библиотеки мог измениться способ создания prompt или набор разрешённых authenticators. Создавайте callback на актуальном Activity или Fragment и обрабатывайте отдельно `onAuthenticationError`, `onAuthenticationFailed` и `onAuthenticationSucceeded`. Сообщение пользователю должно опираться на конкретный результат, а не на общий catch.

При повороте экрана и возврате из background callback должен оставаться связан с текущим экраном. Если успешный ответ приходит в старый объект, UI может ничего не сделать, хотя отпечаток распознан корректно.

Ключ мог стать недоступен — это не повод обходить защиту

Если биометрия защищает ключ в Android Keystore, проверьте параметры его создания, alias и исключения при инициализации CryptoObject. В зависимости от политики ключ может стать недействительным после изменения набора биометрических данных. Также ключ потеряется при смене signing identity, неправильном restore или очистке данных приложения.

Правильный fallback при недоступном ключе — повторная полная аутентификация и выпуск нового ключа. Нельзя считать успешный показ биометрического окна достаточным для выдачи сессии.

Миграция локального состояния после релиза

  • Не переименован ли alias ключа и namespace настроек.
  • Не стала ли старая запись ciphertext читаться новым форматом без версии.
  • Не восстановились ли зашифрованные данные из backup без соответствующего ключа.
  • Не изменился ли applicationId или сертификат подписи между каналами сборки.
  • Есть ли понятный путь из состояния «ключ недоступен» к обычному логину.

Храните версию локального формата рядом с данными. Тогда обновление может выбрать конкретную миграцию, а не пытаться расшифровать всё новым кодом и показывать пользователю ошибку отпечатка.

Приёмочный сценарий для обновления

  1. Установить предыдущую версию, войти и включить биометрический вход.
  2. Обновить приложение поверх неё без очистки данных.
  3. Проверить вход, поворот экрана и возврат из background.
  4. Изменить набор отпечатков и убедиться, что политика ключа отрабатывает предсказуемо.
  5. При недоступном ключе пройти обычный логин, пересоздать привязку и снова войти по биометрии.

Для удалённой диагностики нужны версии приложения и Android, код ошибки BiometricPrompt, класс исключения Keystore и сведения о способе установки. Отпечатки, PIN устройства и содержимое ключей передавать не нужно.

Проверенные источники