AI 가독성이란 웹페이지의 중요한 정보를 AI 에이전트가 정확하고 최신이며 기계가 이해하기 쉬운 형태로 가져갈 수 있느냐를 뜻합니다. 예를 들어 서버가 생성한 HTML에서는 상품 가격이 1.299 TL로 보이는데, JavaScript가 실행된 뒤 브라우저에서는 1.249 TL로 보인다면 두 개의 서로 다른 콘텐츠 레이어가 존재하는 셈입니다. 짧게 말하면, Hydration mismatch 하나만으로 AI 봇에 반드시 오래된 데이터가 전달되는 것은 아닙니다. 하지만 최신 정보가 클라이언트 쪽에서만 로드되거나 SSR 출력이 캐시에 남아 있다면 일부 에이전트는 최초 HTML에 있는 오래되었거나 누락된 데이터를 읽을 수 있습니다.
그래서 목표는 브라우저에서만 올바르게 보이는 페이지를 만드는 것이 아니라, 원시 HTTP 응답, JavaScript가 꺼진 상태의 화면, JavaScript 이후 DOM 사이의 차이를 측정하는 것입니다. AI 시스템이 모두 같은 크롤링 방식을 쓰는 것도 아닙니다. 어떤 시스템은 HTTP 응답만 처리하고, 어떤 시스템은 JavaScript를 실행하는 브라우저를 사용할 수 있습니다. 어떤 레이어가 읽히는지 추측하기보다, 같은 URL에서 6가지 점검을 적용하세요.
Hydration mismatch가 AI 봇에 오래된 데이터를 어떻게 전달하나요?
Hydration mismatch는 서버 HTML과 React가 클라이언트에서 처음 렌더링한 결과가 다를 때 발생합니다. 오래된 데이터의 위험은 대개 stale SSR 캐시, 클라이언트 측 데이터 패칭, 시간이 지나며 바뀌는 값들이 합쳐지면서 생깁니다. 즉, mismatch는 증상이고 데이터 흐름의 불일치가 실제 점검 대상입니다.
SSR은 서버가 브라우저로 보내는 최초 HTML입니다. 이 HTML은 JavaScript가 전혀 실행되지 않아도 볼 수 있는 콘텐츠입니다. Hydration 과정에서 React는 이 마크업에 이벤트 리스너를 연결하고 자신의 가상 트리와 맞춰 봅니다. 첫 클라이언트 렌더가 서버의 텍스트, 속성, 노드 구조와 다르면 콘솔에 오류나 경고가 발생할 수 있습니다. React는 일부 텍스트 차이를 보정할 수 있지만, 그렇다고 해서 콘텐츠가 모든 봇에게 최신 상태로 유지된다는 뜻은 아닙니다.
SSR과 클라이언트 HTML 차이는 어떤 6가지 점검으로 찾을 수 있나요?
1. 최초 HTTP 응답에 최신 데이터가 있나요?
먼저 JavaScript를 실행하지 않은 상태에서 서버가 무엇을 보내는지 기록하세요. 응답 본문에 제목, 가격, 재고, 날짜, 구조화 데이터가 없다면 JS 없이 콘텐츠를 읽을 수 없습니다. 응답이 이미 오래됐다면 문제는 hydration 이전, 즉 데이터 소스나 캐시 계층에 있습니다.
명령줄에서 서로 다른 User-Agent 값으로 같은 URL을 요청하세요. User-Agent만으로 실제 AI 크롤러를 완전히 흉내 내는 것은 아니지만, CDN이나 서버 규칙이 다른 응답을 내보내는지 확인하는 데는 도움이 됩니다.
curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html
2. View Source와 실제 DOM 사이에 무엇이 달라지나요?
브라우저의 View Source는 대체로 서버에서 온 원본 HTML을 보여주고, Elements 패널은 JavaScript 이후의 실시간 DOM을 보여줍니다. 이 두 결과를 따로 저장한 뒤 중요한 콘텐츠 노드를 비교하세요. 가격, 설명, 날짜, 그리고 JSON-LD 안의 값이 같지 않다면 차이의 원인을 짚어야 합니다.
차이가 있다고 해서 항상 SEO 오류인 것은 아닙니다. 예를 들어 React가 이벤트 리스너를 연결한다고 해서 보이는 텍스트가 바뀌지는 않습니다. 반대로 서버에 있던 재고 문구가 클라이언트에서 제거되거나, 클라이언트에서만 추가되는 경우에는 AI 가독성에 직접적인 영향을 줄 수 있습니다.
3. React hydration 오류는 어느 컴포넌트에서 발생하나요?
브라우저 콘솔의 hydration 경고와 component stack 정보를 기록하세요. React 18 이후 버전에서는 hydrateRoot에 onRecoverableError를 사용해 운영 환경의 이벤트를 추적할 수 있습니다. 오류 로그만 없앴다고 해서 문제가 해결된 것은 아닙니다.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration 차이', error.message, info.componentStack);
}
});
오류 메시지는 URL, 컴포넌트, 데이터 버전과 함께 로그로 남기고, 개인정보는 전송하지 마세요. 한 페이지에서 같은 경고가 3개의 서로 다른 컴포넌트에서 보인다면 공통된 날짜 형식, locale 또는 초기 데이터 생성기를 찾아보세요.
4. 날짜, 시간, locale 또는 랜덤 값이 최초 렌더를 바꾸고 있나요?
Date.now(), Math.random(), 브라우저 시간대, 통화 형식, window 같은 소스는 서버와 클라이언트에서 서로 다른 결과를 만들 수 있습니다. 서버에서는 고정된 ISO 날짜나 미리 포맷된 라벨을 생성하고, 클라이언트에서는 변하는 값을 hydration 이후 useEffect 안에서 업데이트하세요.
예를 들어 서버는 UTC, 브라우저는 Europe/Istanbul 시간대에서 실행된다면 같은 타임스탬프가 다른 날짜로 바뀔 수 있습니다. 최초 HTML에 반드시 정확한 날짜를 보여줘야 한다면 텍스트와 데이터 버전을 서버에서 클라이언트로 같은 payload에 실어 보내세요.
5. 최신 데이터가 클라이언트 측 fetch로만 오나요?
콘텐츠가 useEffect 안에서 가져와진다면 JavaScript가 꺼진 클라이언트와 HTTP 응답만 읽는 에이전트에는 보이지 않을 수 있습니다. 중요한 정보는 최초 SSR 응답에 초기 데이터를 넣어야 합니다. 클라이언트 fetch는 마지막 갱신을 가져올 수 있지만, 첫 렌더는 같은 초기값에서 시작해야 합니다.
SSR이 10:00에 생성한 상품 가격과 클라이언트가 10:01에 API에서 받아온 가격이 다르다면 그것은 예상된 업데이트일 수 있습니다. 그러나 AI 에이전트가 최초 HTML만 처리한다면 두 번째 가격은 아예 보지 못합니다. 이 차이는 콘텐츠 소스, 생성 시각, API 응답 시각과 함께 보고하세요.
6. CDN, ISR 또는 애플리케이션 캐시가 오래된 SSR 출력을 유지하고 있나요?
응답 헤더의 Age, ETag, Last-Modified, Cache-Control, 그리고 CDN 고유의 cache 상태를 확인하세요. 서버가 데이터베이스에서 최신 가격을 가져오더라도 CDN이 300초 된 오래된 HTML을 돌려줄 수 있습니다. 콘텐츠가 바뀌는 순간 purge, 짧은 revalidation 또는 적절한 no-store 정책을 적용하세요.
캐시를 끄는 임의의 쿼리 파라미터 테스트는 실제 방문자 경로를 항상 대표하지는 않습니다. 따라서 일반 URL을 서로 다른 네트워크 2~3개에서, 같은 header로, 그리고 타임스탬프를 기록하면서 비교하세요. 200 응답의 본문이 다르다면 variation 규칙도 함께 점검해야 합니다.
기술 점검 목록
- 페이지의 원시 HTML을
curl로 저장하고, 중요한 텍스트, canonical, JSON-LD 필드를 표시하세요. - View Source 출력과 JavaScript 이후의 Elements DOM을 비교하되, 클래스나 이벤트 연결만이 아니라 보이는 콘텐츠 차이를 분리해서 보세요.
- JavaScript를 비활성화한 상태에서 상품, 문서, 서비스에 필요한 정보가 읽히는지 테스트하세요.
- React 콘솔 경고를 URL, 컴포넌트, 데이터 버전과 함께 추적하고,
suppressHydrationWarning을 해결책 대신으로 쓰지 마세요. - 날짜, 시간, locale, 랜덤 값은 첫 렌더에서 제외하거나 서버에서 클라이언트로 같은 값을 전달하세요.
- CDN과 애플리케이션 캐시에서 TTL, ETag, revalidation, purge 흐름을 콘텐츠 업데이트 시점에 검증하세요.
예시 시나리오: 제품 가격은 SSR에서 오래됐고, DOM에서는 최신
한 이커머스 페이지에서 ERP가 상품 가격을 1.249 TL로 업데이트합니다. 하지만 CDN의 300초 TTL 때문에 서버는 여전히 1.299 TL이 들어 있는 HTML을 반환합니다. React 컴포넌트는 hydration 이후 API 호출을 하고, 브라우저에는 1.249 TL이 표시됩니다. 사용자는 Elements 패널에서 올바른 가격을 보지만, JavaScript를 실행하지 않는 AI 리더는 원시 HTML에서 1.299 TL을 찾을 수 있습니다.
올바른 수정은 hydration 경고를 끄는 것이 아닙니다. SSR이 최신 원본에서 데이터를 가져오고, CDN이 ERP 업데이트 이후 정리되며, 클라이언트가 같은 초기값을 사용하도록 해야 합니다. 아래 패턴은 서버 라벨이 첫 클라이언트 렌더에서 유지되도록 하고, API 응답이 온 뒤에만 제어된 방식으로 바뀌게 합니다:
function Price({ initialLabel, initialValue }) {
const [price, setPrice] = useState({
label: initialLabel,
value: initialValue
});
useEffect(() => {
fetch('/api/price/abc', { cache: 'no-store' })
.then(response => response.json())
.then(nextPrice => setPrice(nextPrice));
}, []);
return <p data-price={price.value}>{price.label}</p>;
}
여기서 initialLabel과 initialValue는 SSR과 클라이언트에 동일하게 전달되어야 합니다. API 응답은 예를 들어 { label: '1.249 TL', value: 1249 } 형태일 수 있습니다. 테스트할 때는 먼저 ssr.html 파일을 저장하고, 그다음 JavaScript가 켜진 브라우저의 DOM을 저장한 뒤, diff -u로 가격 노드뿐 아니라 JSON-LD와 접근성 텍스트까지 함께 확인하세요.
페이지가 변하는 데이터를 실제로 클라이언트에서 갱신한다면, 그 갱신이 언제 발생하는지 측정하세요. 예를 들어 180밀리초에 끝나는 fetch는 브라우저 사용자에게는 보일 수 있지만, 서버 응답을 전혀 렌더링하지 않는 에이전트는 그 시간을 경험하지 않습니다. AI 가독성 관점에서 중요한 정보는 최초 HTML 안에 있어야 하며, 그 값은 현재의 데이터 정책과도 맞아야 합니다.
자주 하는 실수
- Hydration 경고를 없애는 것을 오래되었거나 누락된 콘텐츠를 고치는 것으로 착각하기.
- 스크린샷만 확인하고 원시 HTTP 응답은 전혀 보지 않기.
- 가격, 재고, 문서 본문을
useEffect안의 API 호출에만 맡기기. - 서버와 클라이언트에서 다른 locale, 시간대, 통화 형식을 사용하기.
- CDN cache 정리를 검증하지 않은 채 콘텐츠 업데이트가 즉시 배포된다고 가정하기.
- 한 브라우저 봇의 동작을 모든 AI 에이전트에 일반화하기.
결국 hydration mismatch는 먼저 SSR 출력과 클라이언트의 첫 렌더를 비교해야 한다는 신호입니다. 오래된 데이터가 정말 AI 봇에 전달되는지 확인하려면 원시 응답, JavaScript가 꺼진 화면, 실시간 DOM, React 로그, 캐시 헤더를 같은 URL에서 함께 평가하세요.