Jak naprawiłem zduplikowane taby w Expo Router
Expo Router jest całkiem prosty, kiedy taby są całą aplikacją.
Robi się ciekawiej, gdy aplikacja ma taby, ale ma też pełnoekranowe trasy poza tabami, na przykład ekrany szczegółów, ekrany przetwarzania, ekrany wyników, ekrany zakupu albo onboarding.
Tak właśnie wyglądał mój setup.
A bug tak naprawdę nie polegał na tym, że „Expo Router jest zepsuty”.
Bug polegał na tym, że przypadkiem tworzyłem drugie poddrzewo tabów.
Wyglądało na to, że aplikacja wróciła na ekran główny, ale to nie była ta sama instancja tabów.
To zupełnie inny problem niż zwykłe trafienie na zły ekran.
Trafiałem na ekran, który wyglądał poprawnie, ale drzewo tabów pod spodem było świeże.
Prawdziwy tryb awarii wyglądał więc tak: zduplikowane taby, identycznie wyglądający UI, zła instancja.
Dlatego feed mógł się resetować, stan konkretnego taba mógł znikać, a aplikacja mogła sprawiać wrażenie niespójnej, chociaż użytkownik był „z powrotem na ekranie głównym”.
Ten artykuł powstał, bo trafiłem dokładnie na ten problem i musiałem po nim posprzątać.
Moja aplikacja nie miała prostego grafu złożonego tylko z tabów
Kluczowy szczegół był taki:
mój tab navigator nie był całą aplikacją.
Miałem root stack, a taby były tylko jedną gałęzią w jego środku.
<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>
Ta struktura była zamierzona.
Chciałem, żeby details, processing i result były poza tabami, żeby mogły zająć cały ekran i ukryć tab bar.
Ta część była w porządku.
Problem zaczął się, kiedy nawigowałem z powrotem do tabów, jakby /(tabs) było po prostu kolejną zwykłą trasą.
Właśnie tam dochodziło do duplikacji.
Nie zawsze wracałem do istniejącej gałęzi tabów.
Czasem w praktyce tworzyłem nową.
Innymi słowy, w root stacku żyła już jedna powłoka tabów, a ja przypadkiem montowałem drugą, która akurat renderowała ten sam UI ekranu głównego.

Najprostszy sposób na zduplikowanie tabów
Kiedy masz mieszany graf, takie akcje stają się niebezpieczne:
router.replace("/(tabs)/(home)");
router.dismissTo("/");
Wyglądają niewinnie, ale to nie to samo co „wróć do istniejącej instancji tabów”.
Chciałem, żeby działo się to:
root stack
├─ (tabs) // existing tabs instance
├─ details/[id]
├─ processing/[id]
└─ result/[id]
back action -> return to the existing (tabs) branch
A czasem zamiast tego robiłem to:
root stack
├─ (tabs) // original tabs instance still exists
├─ details/[id]
├─ processing/[id]
├─ result/[id]
└─ (tabs) // fresh tabs instance mounted again
Ten drugi przypadek to właśnie prawdziwy bug.
Oznacza, że użytkownik widzi ekran główny i tab bar, ale nie jest już w gałęzi tabów, którą wcześniej zbudował.
W praktyce objawiało się to tak:
- montowanie drugiej gałęzi tabów na wierzchu oryginalnej
- przebudowywanie gałęzi tabów zamiast powrotu do istniejącej
- utrata bieżącego stanu tabów
- utrata pozycji scrolla albo załadowanego stanu taba
- historia nawigacji sprawiająca wrażenie niespójnej
Najgorsze jest to, że łatwo ten bug przeoczyć.
Nadal widzisz ekran główny.
Nadal widzisz tab bar.
Ale teraz siedzisz w świeżej instancji tabów, a nie w tej, którą użytkownik już zbudował.
Dlatego stan tabów wydaje się psuć losowo.

Precyzyjnie określ, czym tak naprawdę jest „home”
Po tym przestałem traktować „idź do home” jako mglisty pomysł.
Zapisałem to wprost:
export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";
A kiedy musiałem wrócić do tabów, celowałem w prawdziwą trasę taba:
router.dismissTo("/(tabs)/(home)");
A nie:
router.dismissTo("/");
router.replace("/(tabs)/(home)");
Ostatecznie oparłem się na dismissTo, ale samo API nie było tu najważniejsze.
Najważniejsze było to, że cel przestał być mglisty.
To była pierwsza prawdziwa poprawka.
Kiedy cel jest precyzyjny, nawigacja przestaje działać na zasadzie „jakoś to będzie” i zaczyna odpowiadać rzeczywistemu grafowi.
Objawem nie był „zły ekran”, tylko „zła instancja”
To rozróżnienie ma znaczenie.
Użytkownik często nadal patrzył na właściwy tab.
Problem polegał na tym, że było to nowe drzewo tabów.
Dlatego usterka objawiała się pośrednio:
- pozycja scrolla znikała
- wcześniej załadowany stan taba znikał
- aplikacja sprawiała wrażenie, że zapomniała, gdzie był użytkownik
- powtarzane flow sprawiały, że stack z czasem zachowywał się coraz dziwniej
Kiedy zacząłem myśleć w kategoriach „czy wracam do istniejącej instancji tabów, czy tworzę nową?”, dużo łatwiej było mi zrozumieć cały problem.
Trzymaj dynamiczne cele powrotu na krótkiej smyczy
Miałem też flow, które przekazywały dalej parametr returnTo.
Ta część szybko robi się nieporządna.
Jeśli pozwolisz dowolnej wartości decydować, dokąd aplikacja ma przejść dalej, skończysz z nawigacją, którą trudno zrozumieć i łatwo zepsuć.
Przyjąłem więc prostą zasadę:
- trzymaj cele powrotu mocno ograniczone
- wracaj do prawdziwej trasy taba, gdy cel jest pusty albo nieprawidłowy
- nie pozwól, żeby „wróć tam, skąd przyszedłeś” odtwarzało inną gałąź aplikacji
Ta część jest mniej ekscytująca niż bug ze zduplikowanymi tabami, ale służy temu samemu celowi:
przywrócić użytkownika do istniejącej gałęzi nawigacji, a nie do świeżej kopii czegoś, co tylko wygląda dobrze.
Co naprawdę to naprawiło
Gdybym miał to streścić w kilku zasadach, byłyby to te:
- nie traktuj
/(tabs)jak ogólnego skrótu do ekranu głównego - używaj dokładnie tej trasy taba, której potrzebujesz, np.
/(tabs)/(home) - myśl w kategoriach „istniejącej instancji tabów”, a nie „jakiejś trasy home”
- przepuszczaj dynamiczne cele powrotu przez małą białą listę
- optymalizuj pod ponowne wejście do bieżącej gałęzi tabów, a nie pod tworzenie nowej
Ostatnie przemyślenia
Głównym błędem było to, że nie rozumiałem grafu wystarczająco dobrze.
Kiedy przyjąłem do wiadomości, że taby to tylko jedna gałąź w większym root stacku, zasady nawigacji stały się dużo prostsze.
I trzeba oddać Expo Routerowi sprawiedliwość: poprawka nie była żadnym brzydkim obejściem.
Trudne było tylko uczciwe przyznanie, jak naprawdę wygląda graf aplikacji.
Taby nie były aplikacją.
Były jednym poddrzewem wewnątrz aplikacji.
Kiedy przestałem luźno nawigować do „home” i zacząłem wracać do dokładnie tej istniejącej gałęzi tabów, problem zduplikowanych tabów zniknął.
Jeśli twoja aplikacja ma mieszany graf z root stackiem i tabami, od tego właśnie bym zaczął.