[심층 원인 분석] 서버 캡처 성공 vs 원격 브라우저 접속 시 글자 깨짐 잔존 현상 4계층 캐시 RCA 보고서

저자: Aegis (Google DeepMind Advanced Agentic Coding / ROOPS Infrastructure Hub)
수용자: 사령관 (Commander), Moojoco (mujoco_sim), Vorno (aistudio_voronoi)
일자: 2026-08-06
버전: v4.0 (로컬 헤드리스 크롬 정상 vs 원격 클라이언트 브라우저 304 Not Modified 디스크 캐시 불일치 심층 RCA 수록)
분류: rca, root-cause-analysis, browser-cache-304, hb5u-8590-deep-analysis, cache-control, roops

1. 개요 및 사령관 질의에 대한 심층 원인 진단

사령관의 명확한 실측 질문("이미지는 한글로 보이는데 왜 직접 접속하면 깨져있지? 좀더 심층 및 단계별 분석이 필요해")에 따라, 서버 로컬 헤드리스 크롬 캡처에서는 한글이 정상 출력되는데 원격 접속 시 여전히 깨져 보이는 4계층 메커니즘을 심층 분석하여 정밀 보고한다.

2. 🔍 4계층 메커니즘 심층 분석 (4-Layer Cache Mechanics)

graph TD
    subgraph Layer1 ["1. 원격 브라우저 HTTP 304 캐시"]
        Client["원격 브라우저 (100.125.27.70)"] --> Req["GET / HTTP/1.1 (If-Modified-Since)"]
        Req --> Resp304["HTTP 304 Not Modified 응답 ➔ 디스크 구버전 GIF 반환!"]
    end

    subgraph Layer2 ["2. 로컬 헤드리스 크롬 비-캐시"]
        Headless["로컬 헤드리스 크롬 (127.0.0.1)"] --> ReqFresh["HTTP 200 OK (새로 생성된 파일 로드 ➔ 정상)"]
    end

    subgraph Layer3 ["3. Python http.server 캐시 헤더 미비"]
        Server["기존 python -m http.server"] --> NoHeader["Cache-Control / ETag 헤더 부재 ➔ 304 재사용 유도"]
    end

    subgraph Layer4 ["4. 해결책: 강제 Cache-Busting & No-Cache 서버"]
        Fix["No-Cache HTTP Server & ?v=20260806_nanum_v3"] --> Fresh["100% 강제 갱신 로드!"]
    end

2.1 계층 1: 원격 브라우저의 HTTP 304 Not Modified 디스크 캐싱 (주 원인)

• 실측 로그 입증:
• 100.125.27.70 - - [06/Aug/2026 08:19:00] "GET / HTTP/1.1" 304 -
• 원리: 사령관님의 원격 PC/모바일 브라우저가 이전에 이미 파이썬 기본 서버로부터 구버전 index.html 및 구버전 amazinghand_...gif를 다운로드받아 로컬 브라우저 디스크 캐시(Disk Cache)에 저장해 두고 있었음.
• 이로 인해 서버의 GIF 파일이 나눔고딕 TTF로 새로 렌더링되었음에도, 원격 브라우저는 서버로 새 GIF를 요청하지 않고 자신의 디스크 캐시에 저장된 옛날 깨진 GIF 이미지를 계속 출력했던 것임.

2.2 계층 2: 로컬 헤드리스 크롬(127.0.0.1)과 원격 브라우저의 차이

• Aegis가 서버 내에서 실행한 google-chrome --headless는 캐시 이력이 없는 깨끗한 세션(Fresh Session)으로 http://127.0.0.1:8590/에 직접 요청을 보내 서버에 새로 생성된 파일(HTTP 200 OK)을 즉시 내려받아 정상 한글 스크린샷이 찍혔던 것임.

3. 🛠️ 3단계 완벽 시정 방안 (3-Step Complete Resolution)

1. Static HTML에 Cache-Busting 파라미터 적용:
2. index.html 내의 GIF 미디어 주소를 https://images.hyperbook.com/amazinghand_egg_grip_force_compliant_handshake.gif?v=20260806_nanum_v3로 변경하여 모든 원격 브라우저가 이전 캐시를 무효화하고 새로운 GIF를 무조건 강제 다운로드하도록 보정.
3. HTML Head 태그에 No-Cache 메타 지정:
4. Cache-Control: no-cache, no-store, must-revalidate 및 Pragma: no-cache 메타 태그 내장.
5. 8590 포트 HTTP 서버를 No-Cache 전용 서버로 개정:
6. server_no_cache.py 커스텀 파이썬 HTTP 서버를 구동하여 HTTP 304 응답을 억제하고 항상 강제 갱신 헤더를 송출.

4. 결론 및 원격 접속자 조치 가이드

원격 브라우저 접속 시 Ctrl + Shift + R (강제 새로고침 / Cmd+Shift+R)을 한번 누르시거나, 캐시 바스팅 파라미터(?v=20260806_nanum_v3)가 적용된 신규 페이지로 접속하시면 즉시 깨짐이 사라진 선명한 나눔고딕 한글 GIF를 감상하실 수 있다.