배포를 마쳤는데 브라우저에서 새 화면이 안 보이는 날이 있어요. 강력 새로고침을 하면 보이고, 일반 새로고침으로는 옛날 화면이 그대로예요. 이럴 때 개발자 도구 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 은 프로토콜 버전과 결과 코드예요. 코드의 첫 숫자만 봐도 큰 그림이 나와요.
- 2xx: 성공이에요. 200 은 정상, 204 는 성공했지만 본문이 없다는 뜻이에요.
- 3xx: 이동이나 캐시 관련이에요. 301·308 은 영구 이동, 302·307 은 임시 이동, 304 는 "바뀐 게 없으니 저장본을 쓰세요"예요.
- 4xx: 요청 쪽 문제예요. 401 은 인증 필요, 403 은 접근 금지, 404 는 없음이에요.
- 5xx: 서버 쪽 문제예요. 502·503·504 는 중간 서버나 과부하 때문에 자주 나와요.
코드가 많이 헷갈리면 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 | 계산 | 사람 말로 |
|---|---|---|
| 60 | 60초 | 1분 |
| 600 | 600 ÷ 60 | 10분 |
| 3600 | 60 × 60 | 1시간 |
| 86400 | 24 × 3600 | 1일 |
| 604800 | 7 × 86400 | 7일 |
| 31536000 | 365 × 86400 | 365일(1년) |
max-age=3600, stale-while-revalidate=86400 이라면 1시간 동안은 서버에 묻지 않고 쓰고, 그 뒤 1일 동안은 저장본을 먼저 보여 주면서 뒤에서 새것을 가져와요. age: 125 가 같이 나오면 이 응답이 중간 서버에 저장된 지 125초(2분 5초)가 지났다는 뜻이라, 1시간에서 125초를 뺀 만큼이 남은 보관 시간이에요.
가장 많이 헷갈리는 건 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 연결에서만 쿠키를 보내요. 빠지면 http 로도 전송될 수 있어요.
- HttpOnly: 자바스크립트의
document.cookie로 읽을 수 없어요. 로그인 세션 쿠키에는 대체로 켜 두는 편이 안전해요. - SameSite: 다른 사이트에서 시작된 요청에 쿠키를 보낼지 정해요. Strict 는 가장 엄격하고, Lax 는 링크 이동 같은 일부만 허용하고, None 은 모두 허용해요. 다만 None 을 쓸 땐 Secure 가 함께 있어야 해요.
보안 헤더도 있는지만 훑어봐요. 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 같은 줄에 세션·토큰 값이 들어 있을 수 있어요. 질문 게시판이나 메신저에 올리기 전에 값 부분은 지우세요.