본문 바로가기
seungchan.dev
뒤로

Next.js 정적 파일을 S3·CloudFront로 옮겨 CPU 스파이크 줄이기

assetPrefix로 /_next/static만 S3 + CloudFront(OAC)로 분리한 구조와 배포 후 캐시 무효화 순서, 같이 챙겨야 했던 이미지 허용·빌드 OOM 설정을 정리했습니다.

6분 읽기#실무 회고#인프라

프로덕션 서버의 CPU가 가끔 크게 튀었습니다. 웹뷰 앱 사용자는 "느려요"라고 말하지 않지만, LCP 지표에는 그대로 드러났습니다.

원인을 따라가 보니 앱 서버가 HTML과 데이터뿐 아니라 JS 번들, CSS, 폰트까지 직접 내보내고 있었습니다. 그래서 /_next/static만 S3와 CloudFront로 옮기고, HTML과 데이터는 지금처럼 앱 서버가 처리하도록 나눴습니다.

앱 서버가 번들 배달까지 떠안고 있었다

증상

프로덕션 CPU가 간헐적으로 스파이크를 쳤고, 웹뷰 앱에서는 LCP가 느려지는 것으로 나타났습니다.

원인으로 본 것

앱 서버(Next 컨테이너와 앞단 nginx)가 HTML·데이터 응답과 함께 번들, CSS, 폰트 같은 정적 파일까지 직접 전송하고 있었습니다. 정적 파일 전송과 Range 요청 같은 일이 모두 오리진에 몰려 있었던 겁니다.

"매 배포마다 해시가 바뀌는 파일을 왜 앱 서버가 직접 내보내고 있지..?" 정적 파일은 한 번 만들어지면 바뀌지 않으니, 앱 서버가 굳이 맡을 이유가 없었습니다.

오리진에서 그대로 낼까, 정적 파일만 CDN으로 뺄까

오리진 직접 전송 vs 정적 파일만 CDN

선택지얻는 것잃는 것
앱 서버가 전부 전송(기존)구조가 단순하고 캐시를 신경 쓸 일이 적음정적 전송·Range 요청이 앱 CPU를 씀
/_next/static만 S3 + CloudFront오리진이 처리할 바이트와 동시 요청이 줄어듦배포 후 캐시 무효화, 이미지 허용, 빌드 설정을 같이 챙겨야 함

HTML과 데이터는 요청마다 달라지지만, 정적 파일은 해시가 붙어 있어 내용이 바뀌지 않습니다. 그래서 HTML과 데이터는 앱에 두고, 정적 파일만 CDN으로 넘기기로 했습니다.

S3를 공개로 열까, OAC로 막을까

S3 버킷을 공개로 열면 설정은 쉽지만 버킷이 인터넷에 그대로 노출됩니다. 그래서 **OAC(Origin Access Control)**로 CloudFront만 버킷을 읽을 수 있게 막았습니다.

긴 캐시와 무효화

정적 파일은 보통 immutable + 긴 max-age로 올립니다. 캐시를 오래 두는 만큼, 배포할 때마다 CloudFront 캐시를 무효화(invalidation)해야 새 파일이 제대로 나갑니다.

assetPrefix로 정적 파일만 S3·CloudFront로 분리

바꾼 건 "정적 파일을 누가 내보내느냐" 하나입니다. 대신 빌드, 배포, 런타임에서 각각 한 가지씩 달라집니다.

빌드 타임: assetPrefix

NEXT_STATIC_ASSET_PREFIX를 주면 Next.js가 정적 파일 URL을 앱 서버가 아니라 CloudFront 주소로 만듭니다. assetPrefix는 JS와 CSS를 어디서 받을지 정하는 설정입니다.

배포 타임: S3 sync와 무효화

CI가 .next/static을 S3에 sync하고, CloudFront에 /_next/static/* 무효화를 요청합니다.

main 푸시 후 빌드, S3 sync, CloudFront 무효화로 이어지는 배포 파이프라인

런타임: 문서는 앱, 번들은 CDN

사용자(WebView 포함)의 요청 중 HTML과 데이터는 앱 서버로 가고, 번들·CSS·폰트는 가까운 CloudFront 엣지(PoP)로 갑니다. S3는 OAC로 막혀 있어서 CloudFront를 거친 요청만 읽을 수 있습니다.

사용자 요청이 앱 서버와 CDN으로 나뉘는 런타임 흐름

배포 후 캐시 갱신 순서

구조는 단순하지만, 문제는 대부분 캐시에서 생깁니다. main 푸시부터 사용자가 새 번들을 받기까지의 순서입니다.

  1. main 푸시 → GitHub Actions가 next build
  2. aws s3 sync로 _next/static 업로드 (immutable + 긴 max-age)
  3. cloudfront create-invalidation으로 /_next/static/* 무효화
  4. 브라우저가 GET .../chunks/해시.js 요청 → 처음엔 S3에서 가져오고(miss), 이후엔 엣지 캐시에서 바로 응답(hit)

CDN만 붙이면 끝나지 않는다

정적 파일 경로만 바꾸면 끝날 것 같았는데, 실제로는 같이 손본 곳이 꽤 많았습니다.

구분내용
CDNassetPrefix + CI에서 .next/static → S3 sync + /_next/static/* 무효화
CloudFront / S3OAC + 버킷 정책으로 CloudFront만 읽기
Docker프로덕션 이미지를 prebuilt standalone으로 조립
Next 이미지remotePatterns에 CloudFront 호스트 추가 (빠뜨리면 Next 이미지 최적화가 요청을 거절함)
빌드 안정성CDN 단계에서 Node OOM이 나지 않게 메모리 옵션 추가
문서docs/deploy-prod-static-cdn-checklist.md — 배포 후 확인 체크리스트

서버가 덜 바쁜 쪽으로

확인 방법

배포 후에는 docs/deploy-prod-static-cdn-checklist.md 체크리스트로 정적 파일이 CloudFront에서 나가는지 확인합니다.

달라진 것

정적 파일을 CloudFront·S3로 넘기면서, 같은 트래픽이라도 오리진(Next 컨테이너와 앞단 nginx)이 처리할 바이트와 동시 요청이 줄었습니다. 정적 전송과 Range 요청이 앱 프로세스에서 빠졌기 때문에 서버 부하가 내려가고, CPU 스파이크도 덜 튀게 됩니다.

웹뷰처럼 네트워크와 메인 스레드에 민감한 환경에서는 LCP·FCP 쪽에서도 차이가 드러나기 쉽습니다.

배운 것

CDN을 붙이는 것 자체는 설정 몇 줄이었습니다. 시간이 걸린 건 캐시 무효화, OAC, 이미지 허용처럼 같이 바꿔야 하는 주변 설정이었습니다. 이걸 함께 챙겨야 배포 후 "왜 옛날 파일이 나오죠?" 같은 문의가 줄어듭니다.

배포 순서는 체크리스트로 남겨 두었습니다. 다음에 누가 배포하더라도 같은 순서로 확인할 수 있게요.