Фраза «не работает отпечаток» скрывает несколько разных сбоев. Системное окно может вообще не открыться, может вернуть ошибку, может подтвердить палец, но не разблокировать ключ, либо приложение получит ключ и упадёт на обновлении серверной сессии. Лечить эти случаи повторной регистрацией отпечатка вслепую не стоит.
Проведите тест обновления со старой 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 или сертификат подписи между каналами сборки.
- Есть ли понятный путь из состояния «ключ недоступен» к обычному логину.
Храните версию локального формата рядом с данными. Тогда обновление может выбрать конкретную миграцию, а не пытаться расшифровать всё новым кодом и показывать пользователю ошибку отпечатка.
Приёмочный сценарий для обновления
- Установить предыдущую версию, войти и включить биометрический вход.
- Обновить приложение поверх неё без очистки данных.
- Проверить вход, поворот экрана и возврат из background.
- Изменить набор отпечатков и убедиться, что политика ключа отрабатывает предсказуемо.
- При недоступном ключе пройти обычный логин, пересоздать привязку и снова войти по биометрии.
Для удалённой диагностики нужны версии приложения и Android, код ошибки BiometricPrompt, класс исключения Keystore и сведения о способе установки. Отпечатки, PIN устройства и содержимое ключей передавать не нужно.