博客

别再把 Expo Router 的 Tabs 搞坏了

2026年2月2日 9 分钟阅读

在 stack 加 tabs 的混合应用里,我如何阻止 Expo Router 挂载一棵只是看起来像同一个首页的全新 tabs 子树。

别再把 Expo Router 的 Tabs 搞坏了
ExpoExpo RouterReact Native导航架构

我是如何修复 Expo Router 中 Tabs 重复问题的

当 tabs 就是整个应用时,Expo Router 用起来相当简单。

但如果你的应用除了 tabs,还有位于 tabs 之外的全屏路由,比如详情页、处理中页面、结果页、购买页或者引导页,事情就变得有意思了。

我的应用就是这种结构。

而这个 bug 其实并不是“Expo Router 坏了”。

真正的问题是,我无意中创建了第二个 tabs 子树。

应用看起来回到了首页,但那已经不是同一个 tabs 实例了。

这和单纯跳到错误的页面是完全不同的问题。

我落到的页面看起来是对的,但底层的 tab 树是全新的。

所以真正的故障模式是:tabs 重复了,界面看起来一样,实例却不对。

这就是为什么信息流可能会被重置,某个 tab 自己的 state 可能会消失,应用的表现也显得前后不一致,尽管用户“已经回到了首页”。

我写这篇文章,就是因为我恰好遇到了这个问题,不得不把它理清楚。

我的应用并不是简单的纯 tabs 导航图

关键细节在于:

我的 tab navigator 并不是整个应用。

我有一个根 stack,tabs 只是其中的一个分支。

<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 之外,这样它们就能占满整个屏幕并隐藏 tab bar。

这部分没问题。

问题出在我每次导航回 tabs 时,都把 /(tabs) 当成了一个普通路由。

重复就是在这里发生的。

我并不总是回到已有的那个 tabs 分支。

有时我实际上是新建了一个。

换句话说,根 stack 里已经有一个 tabs 外壳在运行,而我无意中又挂载了另一个 tabs 外壳,它恰好渲染出了同样的首页界面。

最容易让 tabs 重复的方式

一旦你的导航图是混合结构,下面这些操作就变得危险了:

router.replace("/(tabs)/(home)");
router.dismissTo("/");

它们看起来无害,但并不等同于“回到已有的 tabs 实例”。

我想要的是这样:

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

第二种情况才是真正的 bug。

它意味着用户看到的是首页和 tab bar,但已经不在他们之前一步步建立起来的那个 tab 分支里了。

实际表现为:

  • 在原有的 tabs 分支上又挂载了第二个 tabs 分支
  • 重建 tabs 分支,而不是回到已有的那个
  • 丢失当前的 tab state
  • 丢失滚动位置或已加载的 tab state
  • 导航历史显得前后不一致

麻烦的是,这个 bug 很容易被忽略。

你依然能看到首页。

你依然能看到 tab bar。

但你现在待在一个全新的 tabs 实例里,而不是用户之前已经建立起来的那个。

这就是为什么 tab state 看起来时好时坏。

明确“首页”到底指什么

从那以后,我不再把“回首页”当作一个模糊的概念。

我把它写得很明确:

export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";

当我需要回到 tabs 时,我会指定真正的 tab 路由:

router.dismissTo("/(tabs)/(home)");

而不是:

router.dismissTo("/");
router.replace("/(tabs)/(home)");

最后我在这里主要依赖 dismissTo,但重点并不在这个 API 本身。

重点在于,目的地不再模糊了。

这是第一个真正的修复。

一旦目标明确,导航就不再是“尽力而为”,而是开始和真实的导航图对应起来。

症状不是“页面不对”,而是“实例不对”

这个区别很重要。

用户看到的往往依然是正确的 tab。

问题在于那是一棵新的 tab 树。

所以问题是间接暴露出来的:

  • 滚动位置没了
  • 之前加载的 tab state 没了
  • 应用像是忘了用户刚才在哪儿
  • 重复走几遍流程之后,stack 变得越来越奇怪

当我开始用“我是在回到已有的 tabs 实例,还是在新建一个?”来思考时,整个问题就容易理清多了。

严格限制动态的返回目标

我还有一些流程会一路带着 returnTo 参数。

这部分很快就会变乱。

如果你让任意的值来决定应用下一步去哪儿,最后得到的导航既难以理解,又很容易出问题。

所以我最终定下的规则很简单:

  • 返回目标的范围要非常有限
  • 当目标缺失或无效时,回退到一个真实的 tab 路由
  • 不要让“回到你来的地方”重新创建应用的另一个分支

这部分没有 tabs 重复的 bug 那么有意思,但它服务于同一个目标:

让用户回到已有的导航分支,而不是一个只是看起来对的新副本。

真正解决问题的是什么

如果要把这些压缩成几条规则,大概是这样:

  • 不要把 /(tabs) 当作通用的回首页捷径
  • 使用你真正想去的那个 tab 路由,比如 /(tabs)/(home)
  • 思考“已有的 tabs 实例”,而不是“某个首页路由”
  • 让动态返回目标经过一个小小的白名单
  • 优先重新进入当前的 tabs 分支,而不是新建一个

写在最后

最大的错误在于我对导航图理解得不够透彻。

当我接受 tabs 只是更大的根 stack 中的一个分支之后,导航规则就简单多了。

也要替 Expo Router 说句公道话,修复方法并不是什么难看的变通手段。

难的只是诚实面对应用的导航图到底长什么样。

tabs 并不是整个应用。

它们只是应用里的一棵子树。

当我不再随意地导航到“首页”,而是开始精确地回到已有的那个 tabs 分支后,tabs 重复的问题就消失了。

如果你的应用是根 stack 加 tabs 的混合导航图,我会建议从这里开始排查。