광고
~ / posts / developer
💻 개발자

HTTP 응답 헤더 읽는 법 — cache-control 숫자, set-cookie 속성, 흔히 틀리는 설정 정리

광고

배포를 마쳤는데 브라우저에서 새 화면이 안 보이는 날이 있어요. 강력 새로고침을 하면 보이고, 일반 새로고침으로는 옛날 화면이 그대로예요. 이럴 때 개발자 도구 Network 탭의 Response Headers 에서 한 줄만 읽어도 이유가 나와요. cache-control: max-age=86400 이라면 브라우저가 하루 동안 서버에 묻지 않고 저장본을 쓰는 게 정상이에요.

헤더는 처음 보면 암호 같지만 읽는 순서가 정해져 있어요. 이 글은 상태 줄부터 cache-control, set-cookie, 보안 헤더까지 순서대로 읽는 법과, 초 단위 숫자를 사람 말로 바꾸는 계산, 자주 틀리는 설정을 정리했어요. 헤더를 붙여 넣으면 이 순서로 풀어 주는 HTTP 응답 헤더 분석기도 함께 쓸 수 있어요.

광고

헤더는 어디서 가져오나요

가장 간단한 방법은 터미널의 curl -I https://example.com/ 이에요. -I 는 본문 없이 헤더만 가져와요. 주소가 다른 곳으로 이동하는지 따라가며 보고 싶다면 curl -IL 처럼 -L 을 더해요. 이동이 일어나면 응답이 여러 덩어리로 나오는데, 각 덩어리는 빈 줄로 나뉘어요.

브라우저에서는 개발자 도구(F12) → Network 탭 → 요청 하나를 눌러 Headers 를 보면 돼요. 다만 이 화면에는 브라우저가 붙인 요청 헤더와 서버가 보낸 응답 헤더가 같이 나오니, 응답 쪽(Response Headers)만 복사해야 헷갈리지 않아요.

한 가지 주의할 점이 있어요. 서버가 HEAD 요청(curl -I)에는 GET 요청과 다르게 답하는 경우가 가끔 있어요. 이럴 땐 curl -s -D - -o /dev/null 주소 처럼 본문은 버리고 헤더만 출력해 보면 실제 GET 응답과 같은 값을 볼 수 있어요.

1단계: 상태 줄 읽기

맨 위 한 줄이 상태 줄이에요. HTTP/2 200 은 프로토콜 버전과 결과 코드예요. 코드의 첫 숫자만 봐도 큰 그림이 나와요.

헤더를 읽는 네 단계: 상태 줄, content-type·content-encoding, cache-control·age·etag, set-cookie·보안 헤더
헤더 읽는 순서 4단계

코드가 많이 헷갈리면 HTTP 상태 코드 사전에서 숫자로 찾아보세요. 3xx 응답에는 location 헤더가 같이 나와서, 그 값이 이동할 주소예요.

2단계: 무엇을 어떻게 보냈나

content-type: text/html; charset=utf-8 은 본문이 HTML 이고 UTF-8 이라는 뜻이에요. 이 값이 잘못되면 브라우저가 화면 대신 파일을 내려받으려 하거나, 한글이 깨져 보일 수 있어요. content-encoding: br 이나 gzip 은 본문이 압축돼서 왔다는 표시이고, 브라우저가 알아서 풀어 줘요. content-length 가 있다면 본문 크기(바이트)이고, 압축했다면 압축된 크기예요.

vary: Accept-Encoding 같은 줄도 눈여겨보세요. "같은 주소여도 요청 헤더(여기서는 지원하는 압축 방식)에 따라 응답이 다를 수 있어요"라는 뜻이라, 중간 캐시가 응답을 섞어 쓰지 않게 해 줘요. 이 줄이 빠져서 압축 안 된 응답이 압축 지원 브라우저에 가는 사고가 가끔 생겨요.

3단계: cache-control 숫자를 사람 말로

max-age 는 초 단위 숫자라서 읽기 어려워요. 계산은 어렵지 않아요. 60으로 나누면 분, 3600으로 나누면 시간, 86400으로 나누면 일이에요. 자주 보는 값을 직접 계산해 정리하면 이래요.

max-age계산사람 말로
6060초1분
600600 ÷ 6010분
360060 × 601시간
8640024 × 36001일
6048007 × 864007일
31536000365 × 86400365일(1년)

max-age=3600, stale-while-revalidate=86400 이라면 1시간 동안은 서버에 묻지 않고 쓰고, 그 뒤 1일 동안은 저장본을 먼저 보여 주면서 뒤에서 새것을 가져와요. age: 125 가 같이 나오면 이 응답이 중간 서버에 저장된 지 125초(2분 5초)가 지났다는 뜻이라, 1시간에서 125초를 뺀 만큼이 남은 보관 시간이에요.

cache-control 값별 의미: no-store, no-cache, max-age, 헤더 없음
cache-control 네 가지 의미

가장 많이 헷갈리는 건 no-cache 와 no-store 예요. 이름만 보면 둘 다 "저장 안 함"처럼 보이지만, no-cache 는 저장은 하되 사용하기 전에 서버에 "바뀌었나요?" 하고 확인하라는 뜻이에요. 서버가 304 로 답하면 저장본을 그대로 쓰니 전송량은 줄어요. 결제 화면이나 개인정보 화면처럼 저장 자체가 곤란한 곳에는 no-store 를 써요.

반대로 파일 이름에 해시가 붙는 정적 파일(app.3f9a1c.js 같은)은 내용이 바뀌면 이름도 바뀌니 max-age=31536000, immutable 처럼 길게 잡아도 괜찮아요. HTML 문서는 이름이 그대로라서 길게 잡으면 배포해도 옛 화면이 남아요. 그래서 HTML 은 짧게(또는 no-cache), 해시 붙은 파일은 길게 나누는 구성을 많이 써요.

광고

4단계: set-cookie 와 보안 헤더

set-cookie: sid=abc; Path=/; Secure; HttpOnly; SameSite=Lax 줄에서는 세 가지를 먼저 확인해요.

쿠키 속성: Secure는 https에서만, HttpOnly는 스크립트가 못 읽음, SameSite는 다른 사이트 요청 제한
쿠키 속성 세 가지

보안 헤더도 있는지만 훑어봐요. strict-transport-security(앞으로 https 로만 접속), x-content-type-options: nosniff(형식을 마음대로 추측하지 않기), content-security-policy(불러올 출처 제한), x-frame-options(프레임에 넣는 것 제한), referrer-policy(이전 주소를 얼마나 알릴지)가 대표적이에요. 값이 적절한지는 사이트 구조에 따라 달라서, 있고 없고를 먼저 보고 필요한 것부터 하나씩 더해 가는 게 안전해요.

직접 해 보는 예시: 문제 있는 응답 찾기

아래 응답을 읽어 보세요.

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
Cache-Control: max-age=60
Set-Cookie: token=xyz; SameSite=None
Access-Control-Allow-Origin: *

첫째, Cache-Control 이 두 줄이에요. 하나는 저장 금지, 하나는 60초 보관이라 서로 부딪혀요. 어느 쪽을 따를지 브라우저·프록시마다 다를 수 있으니 한 줄로 합치는 게 좋아요. 둘째, 쿠키에 SameSite=None 이 있는데 Secure 가 없어요. 이 조합은 브라우저가 쿠키를 거부할 수 있어요. 셋째, Access-Control-Allow-Origin: * 은 어느 출처의 스크립트든 이 응답을 읽어도 된다는 뜻이라, 로그인이 필요한 데이터를 주는 API 라면 다시 생각해 봐야 해요. 세 가지 모두 분석기의 '문제 있는 예시' 버튼에서 똑같이 확인할 수 있어요.

광고

헤더와 검색엔진, 같이 점검할 것

검색엔진은 x-robots-tag: noindex 헤더도 읽어요. 페이지 안에 메타 태그가 없는데 색인이 안 된다면 헤더를 확인해 보세요. 이 값은 메타 태그 생성기로 만드는 메타 태그와 같은 역할이지만 PDF·이미지처럼 HTML 이 아닌 파일에도 쓸 수 있다는 점이 달라요. 크롤링 자체를 조절하는 건 robots.txt 생성기가 다루고요. 주소 뒤에 붙은 추적 값을 풀어 보려면 쿼리스트링 분석기가 있어요.

이 글에서 쓴 계산(초 → 일·시간·분)은 직접 나눠 확인했고, 헤더의 일반적인 뜻을 정리한 거예요. 서버 소프트웨어마다 기본값과 처리 방식이 다르니 실제 배포 환경에서는 한 번씩 확인하세요.

자주 묻는 질문

같은 헤더가 두 번 나오는데 괜찮은가요? set-cookie 는 쿠키마다 한 줄씩 나오는 게 정상이에요. 그 외 헤더가 중복이면 서버 설정이 겹쳐서 생긴 경우가 많으니 한 곳에서만 설정하도록 정리하세요.

배포했는데 옛 화면이 보여요. 어디부터 볼까요? HTML 응답의 cache-control 과 age 를 보세요. max-age 가 크거나 age 가 크면 중간 캐시나 브라우저가 저장본을 쓰고 있는 거예요. 시크릿 창에서 열어 비교해 보면 구분하기 쉬워요.

etag 는 꼭 필요한가요? 필수는 아니에요. etag 가 있으면 브라우저가 "이 값 그대로인가요?" 하고 물어 304 로 가볍게 확인할 수 있어서 no-cache 와 같이 쓰기 좋아요.

헤더 이름은 대소문자가 중요한가요? 헤더 이름은 대소문자를 구분하지 않아요. HTTP/2 이상에서는 소문자로 보이는 경우가 많아요.

헤더를 공유할 때 주의할 점은요? set-cookie 나 authorization 같은 줄에 세션·토큰 값이 들어 있을 수 있어요. 질문 게시판이나 메신저에 올리기 전에 값 부분은 지우세요.

#HTTP 응답 헤더#curl -I#cache-control#max-age 계산#no-cache no-store 차이#set-cookie 속성#SameSite#HttpOnly#보안 헤더
← 이전 글사이트맵 XML 만드는 법, robots.txt·noindex와 역할 구분하고 색인 점검하기
광고

더 둘러보기

💻 개발자 다른 도구

🔥 많이 찾는 도구

🔮 재미로 한 번 더

📝 읽어 볼 만한 글

글 전체 보기 →
광고
광고