Гайды

Приложение падает при запуске — 3 причины и как проверить каждую

Иллюстрация: дверь, которая захлопывается прямо на пороге

Самая злая деталь этой поломки задокументирована у Apple: когда приложение запущено из Xcode, сторожевой таймер отключается.

Прочитай ещё раз. У тебя оно не падает не потому, что у тебя всё хорошо, а потому что отладчик выключает ровно тот механизм, который убивает приложение у пользователя. Есть даже отдельная заметка Apple с названием в духе «приложение не падает при запуске из отладчика, но падает при запуске пользователем».

Это общее свойство всех трёх причин ниже: у тебя другая среда, и она мягче. Разберём по порядку — от самой частой.

Причина 1: система убивает за долгий старт

Мобильная ОС даёт приложению ограниченное время на запуск. Не уложился — процесс убивают. В отчёте о падении это видно по коду 0x8badf00d («ate bad food» — у инженеров Apple было чувство юмора). Точные секунды Apple не публикует и меняет между версиями, но порядок — около двадцати на запуск, и для других переходов лимиты бывают куда жёстче.

Ловушка в том, что на твоём телефоне с быстрым интернетом старт занимает секунду. У пользователя в метро тот же запрос висит, пока не отвалится по таймауту.

Как проверить. Отсоедини кабель и запусти приложение прямо с устройства — иконкой, как обычный человек. Если падает только так, ты нашёл. Затем найди отчёт о падении: на iPhone это «Настройки → Конфиденциальность и безопасность → Аналитика → Данные аналитики», на Android — раздел Crashes в Play Console.

Как починить. Из запуска убирается всё, что ждёт: сетевые запросы, чтение большого файла, миграции базы, инициализация тяжёлых библиотек. Правило простое — на старте рисуется экран, а не грузятся данные. Данные приезжают после, уже с индикатором, и старт перестаёт зависеть от сети.

Причина 2: релизная сборка — это другая программа

На Android сжатие и переименование кода включают только в релизной сборке — Google сам рекомендует включать оптимизацию только для той версии, которую ты выкладываешь. И это буквально другой байткод: R8 выкидывает недостижимый код и укорачивает имена классов, com.example.MyActivity превращается в a.b.a.

А теперь угадай, что ломается первым. Всё, что ищет классы по имени в момент выполнения: разбор JSON, библиотеки сериализации, всё «магическое». Инструмент не видит этих обращений в коде и честно удаляет «неиспользуемое».

Как проверить. Собери релизный вариант локально и запусти его на устройстве. Если падает только он — причина эта. Стек-трейс при этом будет нечитаемым, из одних a.b.c — его нужно расшифровать по файлу соответствия имён, который сборка кладёт рядом; в Android Studio для этого есть автоматическая расшифровка, а в Play Console файл соответствия загружается вместе с релизом.

Как починить. Добавить правила «не трогать» для классов, к которым обращаются по имени, — обычно это модели данных. И взять за правило: перед выкладкой запускать именно релизную сборку, а не отладочную. Пять минут, которые снимают целый класс падений.

На iOS аналог помягче, но существует: отладочная сборка не оптимизирует код и терпимее к медленному старту — см. причину 1.

Причина 3: у тебя чистая установка, у них — обновление

Ты ставишь приложение поверх своей же предыдущей сборки или на чистое устройство. Пользователь обновляется поверх версии, которой полгода. И у него на диске лежит то, чего у тебя нет:

  • база данных старой структуры;
  • сохранённые настройки в формате, который ты с тех пор поменял;
  • кэш от прошлой версии;
  • токен входа, который твой новый код разбирает иначе.

Приложение читает это на старте, натыкается на неожиданный формат — и падает раньше, чем успевает показать экран. Симптом характерный: у новых пользователей всё хорошо, жалуются только старые. И «переустановите приложение» действительно помогает — потому что стирает данные.

Как проверить. Установи предыдущую версию из стора или тестовой площадки, попользуйся ей (чтобы создались данные), затем накати новую сборку поверх, не удаляя. Этот сценарий не воспроизводится сам собой — его нужно устраивать руками.

Как починить. Написать миграцию для изменившихся данных и обернуть чтение сохранённого в проверку: не смог разобрать — стирай и начинай с чистого, но не падай. Пользователь переживёт сброс настроек, а вылет на старте — нет.

Порядок действий, если падает прямо сейчас

  1. Запусти без отладчика, с устройства. Воспроизводится — иди в отчёты о падениях.
  2. Прочитай верхние строки отчёта: 0x8badf00d — причина 1; имена вида a.b.c — причина 2; упоминание базы, настроек или разбора данных — причина 3.
  3. Не понял, что в трейсе, — скорми его модели вместе с описанием момента падения. Как это делать правильно, разбирал в чтении сообщений об ошибке.
  4. Не нашёл причину за час — выкатывай прошлую версию, а разбирайся потом. Про то же самое на сервере есть отдельный разбор: работает локально, но не на проде.

Почему в симуляторе всё работает?

Потому что симулятор — это твой компьютер: быстрый процессор, быстрый диск, мгновенная сеть и никаких ограничений по памяти телефона. Он не воспроизводит ни сторожевой таймер, ни медленный старт, ни нехватку памяти. Проверять запуск нужно на реальном устройстве, желательно не на самом новом.

Падает только у части пользователей — как найти общее?

Смотри разбивку в отчётах: версия ОС, модель устройства, версия приложения. Почти всегда там видна закономерность — например, только те, кто обновился с версии до 2.0, или только старые модели, где старт медленнее. Эта разбивка и есть готовая гипотеза, её остаётся воспроизвести.

Помогает ли «просто добавить try/catch» вокруг запуска?

Как временная мера — иногда да, приложение хотя бы откроется. Но чаще ты этим прячешь симптом: экран открылся, а данные не загрузились, и дальше сыпется всё остальное. Обрабатывать нужно конкретное место, где данные могут оказаться неожиданными, и там же решать, что делать: сбросить, пересоздать или показать понятную ошибку.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →