Как я исправил дублирование вкладок в Expo Router
С Expo Router всё довольно просто, когда вкладки и есть всё приложение.
Интереснее становится, когда в приложении есть вкладки, но есть и полноэкранные маршруты вне вкладок: детальные экраны, экраны обработки, экраны результата, экраны покупки или онбординг.
У меня была именно такая конфигурация.
И баг на самом деле был не в том, что «Expo Router сломан».
Баг был в том, что я случайно создавал второе поддерево вкладок.
Приложение выглядело так, будто вернулось на главный экран, но это был уже не тот же экземпляр вкладок.
Это совсем другая проблема, чем просто попасть не на тот экран.
Я попадал на экран, который выглядел правильно, но дерево вкладок под ним было новым.
Так что настоящий сценарий сбоя был таким: продублированные вкладки, интерфейс выглядит так же, но экземпляр не тот.
Поэтому лента могла сбрасываться, state конкретных вкладок мог пропадать, а приложение могло казаться непоследовательным, хотя пользователь «вернулся на главный экран».
Эта статья появилась потому, что я столкнулся ровно с этой проблемой и должен был её разгрести.
В моём приложении был не просто граф из одних вкладок
Важная деталь была такой:
навигатор вкладок не был всем приложением.
У меня был корневой стек, а вкладки были лишь одной веткой внутри него.
<Stack>
<Stack.Screen name="(tabs)" />
<Stack.Screen name="details/[id]" />
<Stack.Screen name="processing/[id]" />
<Stack.Screen name="result/[id]" />
<Stack.Screen name="purchase" />
</Stack>
Такая структура была намеренной.
Я хотел, чтобы details, processing и result находились вне вкладок, чтобы они могли занимать весь экран и скрывать tab bar.
С этим всё было в порядке.
Проблемы начались, когда я продолжал переходить обратно во вкладки так, будто /(tabs) это просто ещё один обычный маршрут.
Именно там и возникало дублирование.
Я не всегда возвращался в существующую ветку вкладок.
Иногда я фактически создавал новую.
Другими словами, в корневом стеке уже была живая оболочка вкладок, а я случайно монтировал ещё одну, которая просто рендерила тот же интерфейс главного экрана.

Самый простой способ продублировать вкладки
Когда у вас смешанный граф, вот такие действия становятся опасными:
router.replace("/(tabs)/(home)");
router.dismissTo("/");
Они выглядят безобидно, но это не то же самое, что «вернуться в существующий экземпляр вкладок».
Я хотел вот этого:
root stack
├─ (tabs) // existing tabs instance
├─ details/[id]
├─ processing/[id]
└─ result/[id]
back action -> return to the existing (tabs) branch
А вместо этого иногда делал вот что:
root stack
├─ (tabs) // original tabs instance still exists
├─ details/[id]
├─ processing/[id]
├─ result/[id]
└─ (tabs) // fresh tabs instance mounted again
Второй случай и есть настоящий баг.
Это значит, что пользователь видит главный экран и tab bar, но уже не находится внутри той ветки вкладок, которую он выстроил до этого.
На практике это проявлялось так:
- поверх исходной ветки вкладок монтировалась вторая
- ветка вкладок пересобиралась вместо возврата к существующей
- терялся текущий state вкладок
- терялась позиция скролла или загруженный state вкладки
- история навигации казалась непоследовательной
Самое неприятное в том, что этот баг легко пропустить.
Вы по-прежнему видите главный экран.
Вы по-прежнему видите tab bar.
Но теперь вы находитесь внутри нового экземпляра вкладок, а не того, который пользователь уже выстроил.
Поэтому state вкладок и кажется сломанным случайным образом.

Точно определите, что значит «главный экран»
После этого я перестал считать «вернуться на главный» расплывчатой идеей.
Я сделал это явным:
export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";
А когда нужно было вернуться во вкладки, я указывал реальный маршрут вкладки:
router.dismissTo("/(tabs)/(home)");
А не:
router.dismissTo("/");
router.replace("/(tabs)/(home)");
В итоге я опирался для этого на dismissTo, но главным был не сам API.
Главным было то, что пункт назначения перестал быть расплывчатым.
Это было первое настоящее исправление.
Когда цель точная, навигация перестаёт работать «как получится» и начинает соответствовать реальному графу.
Симптом был не в «том экране», а в «том экземпляре»
Это различие важно.
Пользователь часто всё ещё смотрел на правильную вкладку.
Проблема была в том, что это было новое дерево вкладок.
Поэтому поломка проявлялась косвенно:
- позиция скролла пропадала
- ранее загруженный state вкладки пропадал
- приложение будто забывало, где был пользователь
- повторяющиеся сценарии со временем делали стек всё более странным
Как только я начал думать в терминах «я возвращаюсь в существующий экземпляр вкладок или создаю новый?», всю проблему стало гораздо проще понять.
Держите динамические цели возврата на коротком поводке
У меня также были сценарии, которые передавали параметр returnTo.
Эта часть может быстро запутаться.
Если позволить любому случайному значению решать, куда приложение пойдёт дальше, вы получите навигацию, которую сложно понять и легко сломать.
Поэтому я остановился на простом правиле:
- цели возврата должны быть очень ограничены
- если цели нет или она некорректна, возвращаемся на реальный маршрут вкладки
- «вернуться туда, откуда пришёл» не должно пересоздавать другую ветку приложения
Эта часть не такая захватывающая, как баг с дублированием вкладок, но она служит той же цели:
вернуть пользователя в существующую ветку навигации, а не в свежую копию чего-то, что только выглядит правильно.
Что на самом деле всё исправило
Если сжать это до нескольких правил, получится так:
- не используйте
/(tabs)как универсальный ярлык на главный экран - указывайте точный маршрут вкладки, например
/(tabs)/(home) - думайте в терминах «существующего экземпляра вкладок», а не «какого-то маршрута на главный»
- пропускайте динамические цели возврата через небольшой белый список
- стремитесь возвращаться в текущую ветку вкладок, а не пересоздавать новую
Итоговые мысли
Главная ошибка была в том, что я недостаточно хорошо понимал граф.
Как только я принял, что вкладки это лишь одна ветка внутри большего корневого стека, правила навигации стали гораздо проще.
И отдам должное Expo Router: исправление не было каким-то уродливым обходным путём.
Сложно было просто честно признать, каким на самом деле был граф приложения.
Вкладки не были приложением.
Они были одним поддеревом внутри приложения.
Как только я перестал переходить на «главный» как попало и начал возвращаться в точно ту же существующую ветку вкладок, проблема с дублированием вкладок исчезла.
Если в вашем приложении смешанный граф из корневого стека и вкладок, я бы начал отсюда.