Next.js 정적 파일을 S3·CloudFront로 옮겨 CPU 스파이크 줄이기
assetPrefix로 /_next/static만 S3 + CloudFront(OAC)로 분리한 구조와 배포 후 캐시 무효화 순서, 같이 챙겨야 했던 이미지 허용·빌드 OOM 설정을 정리했습니다.
프로덕션 서버의 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/* 무효화를 요청합니다.

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

배포 후 캐시 갱신 순서
구조는 단순하지만, 문제는 대부분 캐시에서 생깁니다. main 푸시부터 사용자가 새 번들을 받기까지의 순서입니다.
main푸시 → GitHub Actions가next buildaws s3 sync로_next/static업로드 (immutable + 긴 max-age)cloudfront create-invalidation으로/_next/static/*무효화- 브라우저가
GET .../chunks/해시.js요청 → 처음엔 S3에서 가져오고(miss), 이후엔 엣지 캐시에서 바로 응답(hit)
CDN만 붙이면 끝나지 않는다
정적 파일 경로만 바꾸면 끝날 것 같았는데, 실제로는 같이 손본 곳이 꽤 많았습니다.
| 구분 | 내용 |
|---|---|
| CDN | assetPrefix + CI에서 .next/static → S3 sync + /_next/static/* 무효화 |
| CloudFront / S3 | OAC + 버킷 정책으로 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, 이미지 허용처럼 같이 바꿔야 하는 주변 설정이었습니다. 이걸 함께 챙겨야 배포 후 "왜 옛날 파일이 나오죠?" 같은 문의가 줄어듭니다.
배포 순서는 체크리스트로 남겨 두었습니다. 다음에 누가 배포하더라도 같은 순서로 확인할 수 있게요.
같은 주제의 글
허용 도메인만 열린 교육청 망에서 S3 이미지를 nginx 리버스 프록시로 띄운 기록
서울시교육청 시범 도입 중 화이트리스트 망에서 S3 이미지가 막히자, 이미 허용된 API 도메인 뒤에 nginx 리버스 프록시를 두어 이미지를 서빙한 과정과 트레이드오프를 정리했습니다.
WebView 하단 탭바를 Link와 idle prefetch로 가볍게 만든 기록
Next.js App Router + Flutter WebView에서 전역 5탭·금 모으기 4탭 하단바의 전환 지연, 초기 prefetch 부담, 입장 애니메이션을 라우팅 모델에 맞춰 나눠 푼 과정입니다.
병원 웹앱을 Electron으로 옮기고 웹뷰 구조로 바꾼 이유
로그인 유지와 알림 가시성 때문에 병원용 웹앱을 Electron으로 옮긴 과정, 재시작하지 않는 병원 PC에 맞춰 웹뷰 로드 구조와 GitHub Releases 자동 업데이트로 정리한 이유를 다룹니다.
7분 읽기#실무 회고