“location.href vs replace 차이 때문에 삽질한 이야기”

 하이브리드 앱을 개발하면서 단순한 페이지 이동 로직을 만들었다.

버튼을 누르면 location.href로 다른 페이지로 이동하고,
이전 버튼을 누르면 다시 돌아오는 구조였다.

웹에서는 이전 버튼을 자주 사용하지 않기 때문에
이 부분을 깊게 테스트 해 본적이 없다.

그런데 하이브리드 앱(WebView)에서 테스트하는 순간
문제가 바로 드러났다.

뒤로가기를 누르면 이전 페이지로 돌아가는 것이 아니라
같은 페이지를 계속 반복하면서
무한루프처럼 동작하기 시작했다.

처음에는 WebView 문제라고 생각했다.
하지만 원인은 location.href와 히스토리 스택 구조였다.

location.href로 이동할 때마다
히스토리에 페이지가 계속 쌓이고
뒤로가기를 눌렀을 때 페이지가 다시 로드되면서
이동 스크립트가 또 실행되는 구조가 만들어진 것이다.

흐름은 이렇게 반복된다.

A 페이지 → location.href → B 페이지
B 페이지 → 뒤로가기 → A 페이지
A 페이지 로드 → location.href 실행 → B 페이지

이 과정이 계속 반복되면서
하이브리드 앱에서는 뒤로가기 무한루프가 발생한다.

웹에서도 발생하는 문제지만
하이브리드 앱에서는 시스템 하단의 뒤로가기 버튼이 존재하기 때문에
이 문제가 훨씬 쉽게 드러난다.

특히 Android 물리 백버튼이나
iOS 제스처 뒤로가기와 결합되면
사용자는 앱이 고장난 것처럼 느끼게 된다.

해결 방법은 간단하다.

첫 번째는 location.href 대신
히스토리를 남기지 않는 location.replace를 사용하는 것이다.

location.replace('pageB.php');

이렇게 하면 히스토리가 쌓이지 않아
뒤로가기 루프가 발생하지 않는다.

두 번째는 자동 이동 로직이 한 번만 실행되도록
조건을 추가하는 방법이다.

if (!sessionStorage.getItem('moved')) {
    sessionStorage.setItem('moved', '1');
    location.href = 'pageB.php';
}

이렇게 하면 뒤로가기로 돌아왔을 때
다시 이동하지 않는다.

하이브리드 앱에서는 단순한 location.href 이동도
히스토리 스택을 반드시 고려해야 한다.

웹에서는 잘 드러나지 않던 문제가
하이브리드 앱에서는 바로 사용자 경험 문제로 이어질 수 있다.