스프쌤
스레드

제가 만든 앱이 들어가자마자 로딩 없이 콘텐츠가 바로 뜨게 하고 싶었어요.

✍ @madebyoube⏱ 6분 소요2026-09-28👁
← 목록으로 돌아가기

앱을 껐다 켤 때마다 로딩 화면부터 보는 게 싫어서, 마지막 화면을 디스크에서 먼저 꺼내오는 방법을 정리했습니다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: React Native 콜드 스타트에서 react-query 캐시 persist로 첫 화면 바로 보여 주기

✦ KR 핵심 요약: react-query의 메모리 캐시를 AsyncStorage에 저장해 두었다가 앱 시작 시 복원하면, 콜드 스타트에서도 마지막 데이터를 먼저 보여 주고 네트워크 갱신은 뒤에서 처리할 수 있습니다. 다만 복원은 비동기이고 캐시가 낡을 수 있으므로 복원 시점, 만료 정책, 무효화, 민감정보 분리를 함께 설계해야 합니다.

🌐 Global Takeaway: Persisting the react-query cache to AsyncStorage lets a React Native app render its last known data immediately on cold start while revalidating in the background. The benefit depends on controlling hydration timing, staleness, and which data is safe to store.

앱을 완전히 종료했다가 다시 열면, 화면이 뜨기까지 기다리는 시간이 유난히 길게 느껴집니다. 콘텐츠가 이미 서버에 있고 내 기기 어딘가에 남아 있을 텐데도, 매번 로딩 화면부터 보게 되는 상황이 답답했습니다. 원문 작성자는 React Native 앱의 콜드 스타트마다 로딩 화면이 뜨는 문제를 react-query 캐시를 AsyncStorage에 저장하는 persist 방식으로 풀어 보려 했습니다. 이 글은 그 접근을 사실 범위에서 정리하고, 실제로 적용할 때 확인해야 할 지점을 함께 짚어 봅니다.

콜드 스타트에서 로딩 화면이 뜨는 이유

콜드 스타트는 앱 프로세스가 메모리에 없는 상태에서 새로 시작하는 상황입니다. React Native에서는 JS 런타임과 번들이 초기화되고, 첫 화면이 마운트된 뒤에야 데이터 요청이 나갑니다. 문제는 react-query의 캐시가 기본적으로 메모리에 있다는 점입니다. 앱이 종료되면 캐시도 함께 사라지므로, 다시 켤 때마다 서버 응답을 기다리는 동안 빈 화면이나 로딩 인디케이터를 보게 됩니다.

원문에서는 대기업 앱들이 화면을 바로 보여 주는 내부 구현을 직접 분석한 근거까지는 확인되지 않습니다. 다만 일반적으로는 디스크에 남은 데이터를 먼저 읽거나, 스플래시를 조금 더 유지하거나, 미리 준비한 자리 표시자를 보여 주는 식으로 체감 대기 시간을 줄입니다. 핵심은 데이터가 도착할 때까지 아무것도 보여 주지 못하는 상태를 피하는 것입니다.

persist로 마지막 화면을 먼저 꺼내오기

원문 작성자는 react-query 캐시를 AsyncStorage에 저장하는 persist 방식을 시도했습니다. persist는 메모리 캐시를 직렬화해 디스크에 남겨 두고, 앱이 다시 시작될 때 복원(hydration)하는 접근입니다. 복원된 캐시가 있으면 첫 화면을 즉시 그릴 수 있고, 동시에 네트워크 요청을 보내 최신 데이터로 조용히 바꿀 수 있습니다. 결과적으로 stale-while-revalidate와 비슷한 흐름이 됩니다.

“이러면 부팅할 때 마지막 화면이 바로 뜨고, 백그라운드에서 슬쩍 갱신할 수 있어요!”

복원 시점과 렌더 타이밍

복원은 비동기로 일어납니다. AsyncStorage 읽기가 끝나기 전에 첫 화면이 렌더되면, 캐시가 있어도 잠깐 빈 화면이 보일 수 있습니다. 그래서 복원 완료를 기다렸다가 첫 화면을 그리거나, 네이티브 스플래시를 복원이 끝날 때까지 유지하는 식의 순서 설계가 필요합니다. 원문에서 구체적인 구현 방식까지 확인되지는 않지만, persist를 도입할 때 가장 먼저 부딪히는 지점입니다.

또한 저장과 복원에는 비용이 듭니다. 캐시 전체를 매번 직렬화하면 시작 시간이 느려질 수 있으므로, 첫 화면에 필요한 쿼리를 중심으로 범위를 정하는 편이 안전합니다.

구현할 때 확인할 체크리스트

단계 하는 일 확인할 점
캐시 대상 선정 첫 화면에 필요한 쿼리부터 저장 전부 저장하면 복원 비용과 노출 면적이 커짐
저장소 연결 AsyncStorage에 persister 연결 비동기 읽기, 용량, 민감정보
복원 시점 제어 복원 완료 후 첫 화면 렌더 스플래시 유지 시간과 빈 화면 여부
만료 정책 staleTime·gcTime 조정 오래된 데이터가 언제까지 보이는지
무효화 앱 버전·계정 단위로 캐시 키 분리 업데이트·로그아웃 시 폐기

핵심 정리

  • 콜드 스타트 로딩은 캐시가 메모리에만 있어서 앱 종료와 함께 사라지기 때문에 생깁니다.
  • react-query 캐시를 AsyncStorage에 persist하면 마지막 데이터를 먼저 보여 주고, 갱신은 뒤에서 처리할 수 있습니다.
  • 효과는 복원 시점을 얼마나 잘 제어하느냐에 달려 있습니다. 복원이 끝나기 전에 렌더하면 빈 화면이 다시 보일 수 있습니다.
  • 저장 범위를 넓힐수록 시작 비용과 보안 위험이 함께 커집니다. 첫 화면의 핵심 쿼리부터 시작하는 편이 좋습니다.
  • 캐시는 언젠가 낡습니다. 만료 정책과 버전 무효화, 로그아웃 시 삭제를 함께 설계해야 합니다.

실무 적용 포인트

  1. 첫 화면에 필요한 쿼리 한두 개만 persist 대상으로 시작하세요. 목록이나 상세처럼 진입 빈도가 높은 데이터가 효과가 큽니다.
  2. 복원 완료 신호를 기준으로 첫 렌더를 조정하세요. 스플래시를 조금 더 유지하는 편이 빈 화면을 보여 주는 것보다 낫습니다.
  3. staleTime과 gcTime을 데이터 성격에 맞게 나누세요. 자주 바뀌는 값은 짧게, 잘 바뀌지 않는 값은 길게 가져가는 식입니다.
  4. 앱 버전이나 데이터 스키마가 바뀌면 이전 캐시를 버릴 수 있어야 합니다. 캐시 키에 버전을 두거나 로그인 계정 단위로 분리하세요.
  5. AsyncStorage는 일반적으로 암호화를 제공하지 않는 저장소로 알려져 있습니다. 토큰이나 개인정보는 별도 보안 저장소를 쓰고, 로그아웃 시 캐시를 지우세요.
  6. 개선 효과는 체감으로만 판단하지 말고 첫 콘텐츠 노출까지의 시간, 복원 성공 여부, 갱신 후 깜빡임 여부로 확인하세요.

마무리

persist는 로딩을 없애는 기술이라기보다, 이미 가지고 있는 데이터를 먼저 보여 주는 기술에 가깝습니다. 네트워크는 여전히 필요하고 캐시는 낡을 수 있습니다. 그 전제를 인정하고 복원 시점과 만료 정책을 함께 설계하면, 콜드 스타트에서 빈 화면을 보는 시간을 줄이는 데 도움이 됩니다.

자주 묻는 질문

Q. persist는 모든 쿼리에 적용해야 하나요?
A. 아닙니다. 원문에서도 구체적인 적용 범위는 확인되지 않지만, 일반적으로는 첫 화면에 필요한 핵심 쿼리부터 시작하는 편이 안전합니다. 저장 범위가 넓을수록 복원 비용과 저장 공간, 민감정보가 남을 가능성이 함께 커집니다.

Q. 복원된 캐시가 오래된 데이터면 어떻게 하나요?
A. 복원된 데이터를 먼저 보여 주고 백그라운드에서 다시 요청하는 stale-while-revalidate 방식이 기본입니다. 데이터 성격에 맞게 staleTime과 gcTime을 조정하고, 오래된 값을 보여 주는 동안 새로고침 중임을 알 수 있는 표시를 두는 것이 좋습니다.

Q. AsyncStorage에 로그인 토큰도 같이 저장해도 되나요?
A. 권장하지 않습니다. AsyncStorage는 일반적으로 암호화를 제공하지 않는 key-value 저장소로 알려져 있어 민감정보를 그대로 두기 부적절합니다. 토큰은 별도 보안 저장소에 두고, 로그아웃이나 계정 전환 시 persist 캐시도 함께 삭제하세요.

원본

https://www.threads.com/@madebyoube/post/DZZ7y4ekqvl

함께 보면 좋은 글

댓글 0개