Expo Routerでタブが重複する問題をどう直したか
タブがアプリのすべてであれば、Expo Routerはかなり簡単です。
話が面白くなるのは、アプリにタブがあり、さらにタブの外に全画面のルートもある場合です。詳細画面、処理中画面、結果画面、購入画面、オンボーディングなどです。
私の構成はまさにそれでした。
そしてバグの正体は「Expo Routerが壊れている」ではありませんでした。
バグは、私がうっかり2つ目のタブのサブツリーを作っていたことでした。
アプリはホームに戻ったように見えましたが、それは同じタブのインスタンスではありませんでした。
これは単に間違った画面に着地するのとはまったく別の問題です。
私が着地していたのは正しく見える画面でしたが、その下にあるタブのツリーは新しく作られたものでした。
つまり本当の失敗のパターンは、タブが重複し、UIは同じに見えるのに、インスタンスが違う、というものでした。
だからこそ、ユーザーは「ホームに戻っている」はずなのに、フィードがリセットされたり、タブ固有の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をタブの外に置いて、画面全体を占有し、タブバーを隠せるようにしたかったのです。
そこまでは問題ありませんでした。
問題が始まったのは、/(tabs)をただの普通のルートのように扱って、タブの中へ何度もナビゲートし直していたときです。
そこで重複が起きていました。
私はいつも既存のタブのブランチに戻っていたわけではありませんでした。
ときには、実質的に新しいブランチを作っていたのです。
言い換えると、アプリのルートスタックにはすでにタブのシェルがひとつ生きていて、私はたまたま同じホームのUIを描画する別のタブのシェルを、うっかりマウントしていたのです。

タブを重複させる一番簡単な方法
ナビゲーショングラフが混在していると、次のような操作は危険になります。
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
この2つ目のケースが本当のバグです。
ユーザーにはホーム画面とタブバーが見えていますが、もう以前に積み上げてきたタブのブランチの中にはいないということです。
実際には、次のような形で現れました。
- 元のタブのブランチの上に2つ目のタブのブランチがマウントされる
- 既存のブランチに戻る代わりに、タブのブランチが作り直される
- 現在のタブのstateが失われる
- スクロール位置や読み込み済みのタブのstateが失われる
- ナビゲーションの履歴がちぐはぐに感じられる
厄介なのは、このバグが見落としやすいことです。
ホーム画面は見えています。
タブバーも見えています。
でも実際には、ユーザーがすでに積み上げてきたインスタンスではなく、新しいタブのインスタンスの中にいるのです。
だから、タブの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の名誉のために言っておくと、修正は見苦しい回避策ではありませんでした。
難しかったのは、アプリのグラフが実際にどうなっているのかに正直に向き合うことだけでした。
タブはアプリそのものではありませんでした。
アプリの中のひとつのサブツリーだったのです。
「ホーム」に雑にナビゲートするのをやめ、既存のタブのブランチに正確に戻るようにしたら、タブの重複問題はなくなりました。
もしあなたのアプリがルートスタックとタブが混在したグラフを持っているなら、私ならそこから始めます。