Vary: Accept 없는 Markdown 응답
짧은 답변
페이지가 원래 URL에서 Accept: text/markdown에 Markdown으로 응답하지만, 그 응답에 Vary: Accept 헤더가 없습니다. CDN이나 브라우저 캐시가 Markdown을 저장해 다음 방문자에게 보여 주거나, HTML을 저장해 두고 에이전트에 줄 수 있습니다.
의미
페이지는 text/markdown을 요청받으면 같은 URL에서 Markdown을 반환하지만, 그 응답에 Vary: Accept 헤더가 없습니다. 그러면 CDN이나 브라우저 캐시가 방문자에게 Markdown을 보여 줄 수 있습니다.
AI 검색에서 중요한 이유
캐시는 저장한 응답을 URL로 구분합니다. Vary: Accept는 응답이 Accept 헤더에 따라 달라진다고 캐시에 알려 주므로, HTML과 Markdown이 따로 보관됩니다. 이 헤더가 없으면 먼저 캐시된 버전이 모두에게 제공됩니다.
이 문제는 캐시를 비운 뒤 첫 요청이 에이전트에서 왔을 때만 가끔 나타나므로, 브라우저로는 알아차리기 어렵습니다.
수정 방법
- Markdown 응답과 같은 URL의 HTML 응답 모두에
Vary: Accept를 추가합니다. - 변환이 CDN이나 프레임워크 미들웨어에서 실행된다면 같은 곳에서 헤더를 설정합니다.
- 변경 후 해당 페이지의 캐시를 비웁니다.
- 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.
예시
# both answers of the same URL
Content-Type: text/markdown; charset=utf-8
Vary: Accept 수정 확인 방법
변경한 뒤 리포트에서 "다시 점검"을 누르세요. 무엇이 수정되었고 점수가 어떻게 바뀌었는지 보여 줍니다.