상품의 설명은 모든 방문자에게 같지만, 로그인한 사람에게 표시할 배송지는 다를 수 있습니다. 배송지 조회가 늦다고 상품 설명까지 기다리게 해야 할까요? 이 글에서는 가상의 책 판매 페이지를 예로 들어 공통 본문과 사용자별 영역을 분리하는 판단 과정을 살펴봅니다. 설명할 기능은 Astro의 서버 아일랜드이며, 브라우저에서 버튼을 작동시키는 클라이언트 아일랜드와 역할이 다릅니다.
1. 초기 문서와 나중에 오는 영역 구분하기
Astro 공식 서버 아일랜드 문서는 특정 컴포넌트의 서버 렌더링을 지연하고 결과를 별도 요청으로 받는 방식을 설명합니다. 초기 HTML에는 핵심 본문과 기다리는 동안의 표시를 넣고, 별도 응답이 오면 해당 영역을 교체합니다. 이를 위해 서버에서 요청을 처리할 어댑터가 필요합니다.
책 판매 페이지에서 제목·저자·소개는 공통 문서에 남기고 배송지 요약만 후보로 정해 보겠습니다. 방문자는 배송지를 기다리는 동안에도 책이 무엇인지 읽을 수 있습니다. 반면 주문 총액을 확인해야 결제 버튼을 이해할 수 있다면, 가격과 결제 동작의 관계까지 함께 설계해야 합니다. 보이는 요소를 작은 상자로 자르는 일만으로 기능 분리가 끝나지는 않습니다.
이 설계의 성패는 무엇을 먼저 보여주는지가 결정합니다. 본문을 거의 비워 둔 채 대부분을 지연시키면 방문자는 여러 개의 로딩 표시를 기다리게 됩니다. 첫 화면에서 답해야 하는 질문과 늦게 와도 되는 정보를 먼저 목록으로 나누세요. 서버 아일랜드는 기다림의 위치를 바꾸는 도구이며 데이터베이스 조회 자체를 자동으로 빠르게 만드는 기능은 아닙니다.
2. fallback도 완성된 화면의 일부로 설계하기
다음은 사용 형태를 보여주는 작은 예제입니다. UserDelivery 컴포넌트와 어댑터는 별도로 구현되어 있다는 전제입니다.
---
import UserDelivery from '../components/UserDelivery.astro';
---
<UserDelivery server:defer>
<p slot="fallback">배송지 정보를 확인하고 있습니다.</p>
</UserDelivery>
fallback은 잠깐 나타났다가 사라지는 장식이 아니라 실제로 방문자가 읽는 초기 콘텐츠입니다. 배송지 카드의 최종 크기와 비슷한 공간을 확보하고, 무엇을 기다리는지 설명합니다. 정보가 아직 없는데 “배송 가능”이라고 먼저 표시하면 실제 응답과 의미가 충돌할 수 있습니다. 알 수 없는 상태와 확인된 결과를 시각적으로도 구분해야 합니다.
예를 들어 로그인하지 않은 방문자에게는 “로그인하면 저장한 배송지를 확인할 수 있습니다”라는 안내가 필요할 수 있습니다. 네트워크가 느린 경우와 로그인하지 않은 경우는 다른 상태입니다. 각각의 문구와 이동 경로를 따로 정해 두면 개발 중 편의상 넣은 문장이 운영 화면에 남는 일을 줄일 수 있습니다.
3. 데이터의 경계를 작게 유지하기
컴포넌트를 호출할 때는 표시와 조회에 필요한 값만 전달하세요. 전체 주문 내역을 넘겨 주고 이름 하나만 출력하는 구조라면, 먼저 데이터 의존성을 줄일 여지가 있습니다. 어떤 값은 공개 본문에 있어도 되지만 다른 값은 사용자 인증 뒤에만 조회해야 합니다. 값을 전달하는 경로와 화면에 출력되는 범위를 같은 목록에서 확인합니다.
서버 아일랜드의 요청은 별도 실행 문맥에 있습니다. 현재 페이지의 주소가 필요한 로직이라면 원래 페이지에서 필요한 경로를 명시적으로 전달하는 방식을 검토하세요. 아일랜드 내부의 요청 URL을 원래 상품 페이지 URL로 가정하면, 페이지별 추천이나 되돌아가기 링크가 잘못 만들어질 수 있습니다. 구현 시 실제 요청 주소를 개발자 도구에서 확인하는 편이 안전합니다.
책 번호와 사용자 식별 정보를 다루는 가상 사례를 생각해 볼 수 있습니다. 책 번호는 공통 추천 자료의 조회에 쓰고, 사용자 정보는 서버에서 인증 상태에 따라 처리하도록 역할을 나눕니다. 암호화된 전달 형식을 사용하더라도 서버의 권한 검사를 대신하지는 않습니다. 입력을 받은 위치와 최종 접근 허용을 결정하는 위치를 분리해 문서화하세요.
4. 캐시는 화면의 대상에 맞춰 정하기
공통 책 소개와 개인 배송지에는 같은 캐시 정책을 적용하기 어렵습니다. MDN의 HTTP 캐시 안내는 공유 캐시와 개인 캐시의 구분을 설명합니다. 데이터가 같은지보다 누구에게 보여도 되는 응답인지부터 판단해야 합니다.
테스트 계정 두 개로 같은 페이지를 열어 첫 번째 계정의 배송지가 두 번째 계정에 나타나지 않는지 확인합니다. 로그아웃한 뒤 뒤로 가기나 새로고침을 했을 때도 살펴봅니다. 이 검사는 캐시 서버, 브라우저와 애플리케이션의 인증 처리가 함께 작동한 결과를 대상으로 합니다. 컴포넌트 파일만 읽고 안전하다고 결론 내릴 수는 없습니다.
공통 도서 추천처럼 공유 가능한 부분도 내용이 바뀌었을 때의 갱신 경로가 필요합니다. 오래된 추천을 잠시 허용할 것인지, 관리자가 수정하면 바로 교체할 것인지 정해 보세요. “캐시를 켠다”는 한 문장 대신 대상·보관 위치·허용할 오래됨·무효화 조건을 적으면 다른 개발자도 설계를 검토하기 쉽습니다.
5. 느린 연결과 실패를 먼저 시험하기
정상 연결에서 한 번 열어 본 결과만으로 페이지를 평가하지 않습니다. 배송지 요청을 지연시키고, 실패시키고, 로그인 상태를 바꾼 뒤 각각의 화면을 확인합니다. 핵심 본문을 읽을 수 있는지, 로딩 영역이 다음 버튼을 계속 밀어내는지, 실패한 정보에 의존하는 조작이 가능한지 살펴보세요.
| 시험 상황 | 방문자가 이해해야 할 상태 |
|---|---|
| 배송지 조회가 느림 | 무엇을 기다리며 다른 내용을 읽어도 되는가 |
| 인증되지 않음 | 로그인 안내와 공통 설명이 보이는가 |
| 조회 실패 | 빈 화면 대신 복구 경로를 찾을 수 있는가 |
| 계정 변경 | 이전 사용자의 정보가 남지 않는가 |
여러 아일랜드가 서로의 결과를 기다린다면 분리 방식도 다시 검토해야 합니다. 배송지 결과를 받은 뒤 배송비를 조회하고 그 뒤 결제 안내를 그리는 구조는 대기 요청이 연속될 수 있습니다. 이때는 관련 정보를 하나의 서버 작업으로 묶거나, 사용자가 요청하는 시점에 조회하는 편이 나을 수 있습니다. 분리 개수가 많다는 이유만으로 좋은 구조가 되지는 않습니다.
6. 적용 전후의 이득을 같은 조건에서 비교하기
비교 기록에는 첫 본문이 보인 시점, 배송지 표시 완료, 조작 가능 시점과 오류 상태를 나누어 적습니다. 초기 문서가 빨리 보여도 배송지 카드가 크게 이동하거나 결제 시작이 늦어졌다면 방문자의 경험은 다른 방향으로 바뀔 수 있습니다. 평균값 하나만 적지 말고 느린 사례에서 무엇을 기다렸는지도 함께 남기세요.
서버 아일랜드 후보를 고르는 질문은 구체적일수록 좋습니다. “이 사이트는 정적 페이지인가?”보다 “이 정보가 늦어져도 책 소개를 먼저 읽을 수 있는가?”가 구현 결정에 도움이 됩니다. Astro의 온디맨드 렌더링 안내와 함께 배포 환경을 확인한 뒤, 작은 사용자별 영역 하나부터 실제 실패 상황까지 검증해 보세요.