파이썬 Flask HTTP 캐싱 가이드, ETag Last-Modified Cache-Control 조건부 요청 최적화

🚀 Flask에서 HTTP 캐싱 이해하기

웹 애플리케이션 성능을 높이는 가장 효율적인 방법 중 하나는 캐싱입니다.
Flask는 경량 웹 프레임워크로, 기본적으로는 캐시 정책을 직접 구현해야 하지만 HTTP 프로토콜의 표준 헤더를 통해 충분히 강력한 최적화를 실현할 수 있습니다.
HTTP 캐싱은 브라우저와 서버가 동일한 리소스를 불필요하게 주고받지 않도록 막아줍니다.
이는 곧 네트워크 트래픽 감소, 서버 부하 완화, 사용자 응답 속도 개선으로 이어집니다.

Flask에서 캐싱을 이해하려면 두 가지 레벨을 구분해야 합니다.
첫째는 브라우저 캐시와 중간 캐시(CDN, 프록시)가 관여하는 HTTP 헤더 기반 캐싱입니다.
둘째는 Flask 내부에서 Redis, Memcached 같은 저장소를 활용하는 애플리케이션 레벨 캐싱입니다.
이번 글에서는 HTTP 캐싱, 특히 ETag, Last-Modified, Cache-Control을 중심으로 다룹니다.

📌 캐싱의 주요 효과

• ⚡서버 처리 시간을 줄이고 응답 속도를 크게 향상
• 🌍CDN과 브라우저 캐시를 활용해 전 세계 어디서든 빠른 접속 제공
• 💸불필요한 데이터 전송을 줄여 인프라 비용 절감

📌 Flask와 HTTP 헤더의 관계

Flask는 WSGI(Web Server Gateway Interface) 기반 프레임워크로, 모든 응답에 헤더를 손쉽게 추가할 수 있습니다.
따라서 라우트 함수에서 캐싱 정책을 세밀하게 제어하는 것이 가능합니다.
예를 들어, 정적 파일은 Cache-Control: public, max-age=31536000과 같이 장기 캐싱을 설정하고, JSON API는 ETag와 조건부 요청을 이용해 최신 상태를 보장하는 식입니다.

🧩 ETag와 If-None-Match 조건부 요청

ETag(Entity Tag)는 서버가 리소스의 버전을 구분하기 위해 생성하는 고유 식별자입니다.
리소스가 변경되지 않았다면 클라이언트는 이전에 받은 ETag 값을 함께 전송하고, 서버는 이를 비교해 수정 여부를 판단합니다.
변경이 없다면 304 Not Modified 응답을 반환해 본문 전송을 생략합니다.
이 방식은 트래픽 절약은 물론, 데이터 일관성을 유지하는 데도 효과적입니다.

Flask에서 ETag를 활용하면 JSON API나 HTML 콘텐츠의 최신 상태를 효율적으로 관리할 수 있습니다.
예를 들어 DB의 특정 레코드를 읽을 때 레코드의 해시값이나 수정 시각을 기반으로 ETag를 생성하면, 클라이언트는 동일한 리소스 요청 시 굳이 다시 내려받을 필요가 없습니다.
ETag는 특히 데이터 변경 주기가 길거나, 빈번한 조회가 발생하는 엔드포인트에서 성능을 극대화합니다.

📌 Flask에서 ETag 구현 예제

from flask import Flask, request, make_response
import hashlib

app = Flask(__name__)

@app.route("/data")
def get_data():
    content = {"message": "Hello Cache!"}
    etag = hashlib.md5(str(content).encode()).hexdigest()

    if request.headers.get("If-None-Match") == etag:
        return make_response("", 304)

    response = make_response(content, 200)
    response.headers["ETag"] = etag
    return response

위 예제에서는 JSON 응답의 내용을 MD5 해시로 변환해 ETag를 생성했습니다.
클라이언트가 동일한 콘텐츠를 요청할 때 If-None-Match 헤더를 비교해 변경이 없으면 304 상태 코드만 반환합니다.
이 방식은 REST API 최적화에서 매우 널리 활용됩니다.

🕰️ Last-Modified와 If-Modified-Since 동작

Last-Modified 헤더는 서버가 특정 리소스를 마지막으로 수정한 시각을 알려주는 메타데이터입니다.
클라이언트는 이 값을 저장해 두었다가 이후 요청 시 If-Modified-Since 헤더와 함께 전송합니다.
만약 서버에서 해당 시각 이후로 리소스가 변경되지 않았다면 304 Not Modified를 반환하고, 본문 데이터는 내려주지 않습니다.

이 방식은 정적 파일이나 변경 주기가 일정한 데이터에 특히 유용합니다.
브라우저가 캐시 유효성을 빠르게 검증할 수 있기 때문에 네트워크 왕복 비용을 크게 줄일 수 있습니다.
다만, 초 단위보다 더 세밀한 변경을 추적하기 어렵고, 서버와 클라이언트 간의 시계 불일치 문제가 발생할 수 있다는 점은 주의해야 합니다.

📌 Flask에서 Last-Modified 구현 예제

from flask import Flask, request, make_response
from datetime import datetime

app = Flask(__name__)

last_modified_time = datetime(2025, 1, 1, 12, 0, 0)

@app.route("/resource")
def resource():
    if_modified_since = request.headers.get("If-Modified-Since")

    if if_modified_since == last_modified_time.strftime("%a, %d %b %Y %H:%M:%S GMT"):
        return make_response("", 304)

    response = make_response("Updated resource content", 200)
    response.headers["Last-Modified"] = last_modified_time.strftime("%a, %d %b %Y %H:%M:%S GMT")
    return response

위 코드에서는 리소스의 최종 수정 시간을 Last-Modified 헤더에 담아 응답합니다.
클라이언트가 동일한 리소스를 다시 요청할 때 If-Modified-Since를 비교해 변경이 없다면 304 상태 코드만 반환합니다.

🧱 Cache-Control과 캐싱 전략 설계

Cache-Control 헤더는 HTTP 캐싱 정책의 핵심을 담당합니다.
이 헤더를 통해 브라우저와 중간 캐시 서버(CDN, 프록시)에게 리소스를 얼마나 오래, 어떤 조건으로 저장할 수 있는지 지시할 수 있습니다.
잘못 설정하면 최신 데이터가 노출되지 않거나 캐시가 전혀 활용되지 않는 문제가 발생하므로, 올바른 전략 수립이 필요합니다.

📌 주요 디렉티브 정리

📌 Flask에서 Cache-Control 적용하기

from flask import Flask, make_response

app = Flask(__name__)

@app.route("/static-resource")
def static_resource():
    response = make_response("Static data with caching")
    response.headers["Cache-Control"] = "public, max-age=3600, must-revalidate"
    return response

위 예제에서는 캐시가 1시간 동안 유효하며, 만료 시 반드시 서버 검증을 거치도록 설정했습니다.
정적 리소스, 이미지, CSS 파일에 주로 활용할 수 있으며 CDN 환경에서도 안정적으로 동작합니다.

💬 Cache-Control은 ETag, Last-Modified와 조합해 사용하면 더 큰 효과를 발휘합니다.
단일 헤더로 모든 문제를 해결하기보다는, 리소스 성격에 맞는 혼합 전략을 설계하는 것이 중요합니다.

🧪 Flask 코드 예제와 검증 체크리스트

캐싱 헤더는 이론만으로는 이해하기 어렵습니다.
실제로 Flask 애플리케이션에 적용하고, 브라우저 개발자 도구나 curl을 이용해 검증해 보는 것이 가장 확실한 학습 방법입니다.
아래 예제는 ETag, Last-Modified, Cache-Control을 동시에 적용한 통합 코드입니다.

from flask import Flask, request, make_response
from datetime import datetime
import hashlib

app = Flask(__name__)

@app.route("/article")
def article():
    content = "Sample article content"
    etag = hashlib.md5(content.encode()).hexdigest()
    last_modified = datetime(2025, 1, 15, 12, 0, 0)

    # 조건부 요청 처리
    if request.headers.get("If-None-Match") == etag:
        return make_response("", 304)
    if request.headers.get("If-Modified-Since") == last_modified.strftime("%a, %d %b %Y %H:%M:%S GMT"):
        return make_response("", 304)

    response = make_response(content, 200)
    response.headers["ETag"] = etag
    response.headers["Last-Modified"] = last_modified.strftime("%a, %d %b %Y %H:%M:%S GMT")
    response.headers["Cache-Control"] = "public, max-age=600, must-revalidate"
    return response

위 코드는 콘텐츠가 동일하면 304 응답을 반환하고, 클라이언트가 불필요한 데이터를 받지 않도록 최적화합니다.
또한 Cache-Control로 10분 동안 캐시가 유지되도록 지정했습니다.
ETag와 Last-Modified를 함께 사용하는 것은 일반적인 베스트 프랙티스입니다.

📌 검증 체크리스트

• 🔍curl -I 명령으로 ETag, Last-Modified, Cache-Control 헤더 확인
• 📡304 Not Modified 응답이 예상대로 내려오는지 테스트
• 🕵️브라우저 개발자 도구의 Network 탭에서 리소스가 (from disk cache) 또는 (304)로 표시되는지 확인
• ⚙️정적 파일과 동적 API의 캐싱 정책이 서로 충돌하지 않는지 검토

❓ 자주 묻는 질문 (FAQ)