Expo Router에서 중복된 탭 문제를 해결한 방법
탭이 앱의 전부일 때 Expo Router는 꽤 쉽습니다.
하지만 앱에 탭이 있으면서, 탭 바깥에 상세 화면, 처리 화면, 결과 화면, 구매 화면, 온보딩 같은 전체 화면 라우트도 있으면 이야기가 더 재미있어집니다.
제 앱이 바로 그런 구조였습니다.
그리고 버그는 사실 "Expo Router가 고장 났다"가 아니었습니다.
버그는 제가 실수로 두 번째 탭 서브트리를 만들고 있었다는 것이었습니다.
앱은 홈으로 돌아간 것처럼 보였지만, 같은 탭 인스턴스가 아니었습니다.
이것은 단순히 엉뚱한 화면에 도착하는 것과는 전혀 다른 문제입니다.
제가 도착한 화면은 올바르게 보였지만, 그 밑의 탭 트리는 새로 만들어진 것이었습니다.
그러니까 진짜 실패 양상은 이랬습니다. 탭이 중복되고, UI는 똑같아 보이고, 인스턴스는 엉뚱합니다.
그래서 사용자가 "홈으로 돌아왔는데도" 피드가 초기화되고, 탭별 상태가 사라지고, 앱이 일관성 없게 느껴질 수 있었습니다.
이 글은 제가 정확히 그 문제를 겪고 정리해야 했기 때문에 쓰게 되었습니다.
제 앱은 탭만 있는 단순한 그래프가 아니었습니다
중요한 점은 이것이었습니다.
탭 내비게이터가 앱 전체가 아니었습니다.
루트 스택이 있었고, 탭은 그 안의 한 가지(branch)일 뿐이었습니다.
<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
이 두 번째 경우가 진짜 버그입니다.
사용자는 홈 화면과 탭 바를 보지만, 더 이상 이전에 쌓아 온 탭 가지 안에 있지 않다는 뜻입니다.
실제로는 이렇게 나타났습니다.
- 원래 탭 가지 위에 두 번째 탭 가지가 마운트됨
- 기존 탭 가지로 돌아가는 대신 탭 가지를 다시 만듦
- 현재 탭 상태가 사라짐
- 스크롤 위치나 불러온 탭 상태가 사라짐
- 내비게이션 히스토리가 일관성 없게 느껴짐
고약한 점은 이 버그를 놓치기 쉽다는 것입니다.
여전히 홈 화면이 보입니다.
여전히 탭 바가 보입니다.
하지만 이제 사용자가 쌓아 온 탭 인스턴스가 아니라 새로운 탭 인스턴스 안에 있는 것입니다.
그래서 탭 상태가 무작위로 깨지는 것처럼 느껴집니다.

"홈"이 실제로 무엇을 뜻하는지 정확히 하세요
그 뒤로 저는 "홈으로 가기"를 막연한 개념으로 다루지 않게 되었습니다.
명시적으로 만들었습니다.
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 자체가 아니었습니다.
중요한 건 목적지가 더 이상 막연하지 않게 되었다는 점이었습니다.
그것이 첫 번째 진짜 해결책이었습니다.
목표가 정확해지면 내비게이션은 "최선을 다해 보는" 수준에서 벗어나 실제 그래프와 맞아떨어지기 시작합니다.
증상은 "잘못된 화면"이 아니라 "잘못된 인스턴스"였습니다
이 구분이 중요합니다.
사용자는 대개 여전히 올바른 탭을 보고 있었습니다.
문제는 그것이 새 탭 트리였다는 점이었습니다.
그래서 문제가 간접적으로 드러났습니다.
- 스크롤 위치가 사라짐
- 전에 불러온 탭 상태가 사라짐
- 앱이 사용자가 어디 있었는지 잊어버린 것처럼 느껴짐
- 같은 흐름을 반복할수록 스택이 점점 이상하게 느껴짐
"기존 탭 인스턴스로 돌아가는 걸까, 새로 만드는 걸까?"라는 관점으로 생각하기 시작하자 문제 전체를 훨씬 쉽게 따져 볼 수 있었습니다.
동적인 복귀 목적지는 짧은 목줄에 묶어 두세요
returnTo 파라미터를 들고 다니는 흐름도 있었습니다.
이 부분은 금방 지저분해질 수 있습니다.
아무 값이나 앱이 다음에 갈 곳을 정하게 두면, 이해하기도 어렵고 망가지기도 쉬운 내비게이션이 됩니다.
그래서 제가 정한 규칙은 단순했습니다.
- 복귀 목적지는 아주 제한적으로 둔다
- 목적지가 없거나 유효하지 않으면 실제 탭 라우트로 대체한다
- "온 곳으로 돌아가기"가 앱의 다른 가지를 새로 만들게 두지 않는다
이 부분은 중복 탭 버그보다 덜 흥미롭지만, 같은 목표를 뒷받침합니다.
겉보기에만 맞는 새 복사본이 아니라, 기존 내비게이션 가지로 사용자를 돌려보내는 것입니다.
실제로 문제를 해결한 것
몇 가지 규칙으로 줄이자면 이렇습니다.
/(tabs)를 범용 홈 바로가기처럼 다루지 않는다/(tabs)/(home)처럼 원하는 탭 라우트를 정확히 쓴다- "어떤 홈 라우트"가 아니라 "기존 탭 인스턴스"의 관점으로 생각한다
- 동적인 복귀 목적지는 작은 화이트리스트를 거치게 한다
- 새 탭 가지를 만드는 것이 아니라 현재 탭 가지로 다시 들어가는 것을 기준으로 최적화한다
마무리
가장 큰 실수는 그래프를 충분히 이해하지 못한 것이었습니다.
탭이 더 큰 루트 스택 안의 한 가지일 뿐이라는 걸 받아들이자 내비게이션 규칙이 훨씬 단순해졌습니다.
그리고 Expo Router를 위해 말하자면, 해결책은 지저분한 우회책이 아니었습니다.
어려운 부분은 그저 앱 그래프가 실제로 어떤 모양인지 솔직하게 인정하는 것이었습니다.
탭이 앱 전체가 아니었습니다.
탭은 앱 안의 서브트리 하나였습니다.
"홈"으로 대충 이동하는 것을 그만두고 정확히 기존 탭 가지로 돌아가기 시작하자 중복 탭 문제는 사라졌습니다.
앱에 루트 스택과 탭이 섞인 그래프가 있다면, 저라면 거기서부터 시작하겠습니다.