قابلیت خواندهشدن توسط AI یعنی اطلاعات مهم یک صفحهٔ وب بتوانند بهدرستی، بهروز و بهشکل قابلفهم برای ماشین توسط agentهای هوش مصنوعی دریافت شوند. برای مثال اگر قیمت یک محصول در HTML تولیدشده توسط سرور 1.299 TL باشد اما بعد از اجرای JavaScript در مرورگر 1.249 TL دیده شود، یعنی دو لایهٔ محتوایی متفاوت داریم. پاسخ کوتاه: Hydration mismatch بهتنهایی لزوماً دادهٔ قدیمی به AI bot نمیفرستد؛ اما اگر اطلاعات بهروز فقط سمت کلاینت بارگذاری شوند یا خروجی SSR در کش بماند، بعضی agentها ممکن است دادهٔ قدیمی یا ناقص موجود در HTML اولیه را بخوانند.
به همین دلیل هدف فقط ساختن صفحهای نیست که در مرورگر درست دیده شود؛ باید تفاوت بین پاسخ خام HTTP، نمای بدون JavaScript و DOM پس از JavaScript را اندازهگیری کنید. همهٔ سیستمهای AI از یک روش crawling استفاده نمیکنند: بعضیها فقط پاسخ HTTP را پردازش میکنند، بعضیها ممکن است از مرورگری استفاده کنند که JavaScript را اجرا میکند. بهجای حدس زدن اینکه کدام لایه خوانده میشود، 6 کنترل زیر را روی یک URL واحد اجرا کنید.
Hydration mismatch چگونه دادهٔ قدیمی را به AI bot میرساند؟
Hydration mismatch وقتی رخ میدهد که HTML سرور با اولین render سمت کلاینت در React متفاوت باشد. ریسک دادهٔ قدیمی بیشتر از همه از کشِ stale در SSR، واکشی داده در سمت کلاینت، یا ترکیب مقادیری که با گذشت زمان تغییر میکنند بهوجود میآید. بنابراین mismatch فقط یک نشانه است؛ منبع اصلی بررسی، ناسازگاری در جریان داده است.
SSR همان HTML اولیهای است که سرور به مرورگر میفرستد. این HTML محتوایی است که حتی پیش از اجرای JavaScript هم قابل مشاهده است. هنگام hydration، React به این نشانهگذاری event listenerها را وصل میکند و آن را با درخت مجازی خودش تطبیق میدهد. اگر اولین render سمت کلاینت از متن، attribute یا ساختار nodeهای سمت سرور متفاوت باشد، ممکن است در کنسول خطا یا هشدار ببینید. هرچند React بعضی اختلافهای متنی را اصلاح میکند، این رفتار به این معنی نیست که محتوا برای همهٔ botها بهروز میماند.
فاصلهٔ بین SSR و HTML سمت کلاینت را با چه 6 کنترلی پیدا کنید؟
1. آیا در اولین پاسخ HTTP دادهٔ بهروز وجود دارد؟
اول بدون اجرای JavaScript ثبت کنید که سرور دقیقاً چه میفرستد. اگر در body پاسخ، عنوان، قیمت، موجودی، تاریخ یا دادهٔ ساختیافته وجود نداشته باشد، محتوا بدون JS قابل خواندن نیست. اگر پاسخ قدیمی باشد، مشکل قبل از hydration و در لایهٔ منبع داده یا cache است.
در خط فرمان، همان URL را با User-Agentهای مختلف دریافت کنید. 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، DOM زنده بعد از JavaScript را نمایش میدهد. این دو خروجی را جداگانه ذخیره کنید و گرههای مهم محتوا را با هم مقایسه کنید. اگر قیمت، توضیح، تاریخ و مقادیر داخل JSON-LD یکسان نیستند، منبع اختلاف را مشخص کنید.
وجود اختلاف همیشه به معنی خطای SEO نیست. برای مثال وصل شدن event listener توسط React متن قابلدیدن را تغییر نمیدهد. در مقابل، حذف شدن یک متن مربوط به موجودی در سرور یا اضافه شدن آن فقط در کلاینت میتواند مستقیماً روی AI readability اثر بگذارد.
3. خطای hydration React در کدام component رخ میدهد؟
هشدار hydration و اطلاعات component stack را از کنسول مرورگر ثبت کنید. در React 18 و نسخههای بعدی میتوانید برای hydrateRoot از onRecoverableError استفاده کنید تا رویدادهای محیط production را زیر نظر بگیرید. فقط ساکت کردن log به این معنی نیست که مشکل حل شده است.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration farkı', error.message, info.componentStack);
}
});
پیام خطا را همراه با URL، component و نسخهٔ داده log کنید؛ دادهٔ شخصی ارسال نکنید. اگر در یک صفحه همین هشدار را در 3 component مختلف میبینید، دنبال یک تاریخفرمت مشترک، locale یا تولیدکنندهٔ دادهٔ اولیه بگردید.
4. آیا تاریخ، ساعت، locale یا مقدار تصادفی render اول را تغییر میدهد؟
منابعی مثل Date.now(), Math.random(), timezone مرورگر، قالب پول و window میتوانند در سرور و کلاینت نتایج متفاوتی تولید کنند. روی سرور یک تاریخ ثابت ISO یا یک برچسب از پیش فرمتشده تولید کنید؛ مقدار متغیر را در کلاینت، بعد از hydration و داخل useEffect بهروزرسانی کنید.
برای مثال اگر سرور در UTC اجرا شود و مرورگر در timezone اروپا/استانبول، همان timestamp ممکن است به روز دیگری تبدیل شود. اگر لازم است در HTML اولیه تاریخ قطعی نمایش دهید، هم متن و هم نسخهٔ داده را در یک payload یکسان از سرور به کلاینت منتقل کنید.
5. آیا دادهٔ بهروز فقط از fetch سمت کلاینت میآید؟
اگر یک محتوا داخل useEffect واکشی شود، در کلاینتی که JavaScript خاموش دارد و در agentی که فقط پاسخ HTTP را میخواند ممکن است اصلاً دیده نشود. برای اطلاعات حیاتی، دادهٔ شروع را در اولین پاسخ SSR قرار دهید. fetch سمت کلاینت میتواند آخرین بهروزرسانی را بگیرد؛ اما اولین render باید از همان مقدار اولیه شروع شود.
اگر قیمت محصولی که SSR در ساعت 10:00 تولید کرده با قیمتی که کلاینت در 10:01 از API میگیرد فرق کند، این میتواند یک بهروزرسانی مورد انتظار باشد. اما اگر AI agent فقط HTML اولیه را پردازش کند، اصلاً قیمت دوم را نمیبیند. این اختلاف را همراه با منبع محتوا، زمان تولید و زمان پاسخ API گزارش کنید.
6. آیا CDN، ISR یا cache برنامه خروجی قدیمی SSR را نگه میدارند؟
هدرهای پاسخ مثل Age, ETag, Last-Modified, Cache-Control و وضعیت cache مخصوص CDN را بررسی کنید. حتی اگر سرور قیمت بهروز را از پایگاه داده بگیرد، CDN ممکن است 300 ثانیه HTML قدیمی برگرداند. درست در لحظهٔ تغییر محتوا، از purge، revalidation کوتاه یا یک سیاست مناسب no-store استفاده کنید.
آزمایشی که با یک query parameter تصادفی برای غیرفعال کردن cache انجام میشود، همیشه نمایندهٔ مسیر واقعی کاربر نیست. بنابراین URL عادی را از 2 یا 3 شبکهٔ متفاوت، با همان headerها و همراه با ثبت timestamp مقایسه کنید. اگر body پاسخ 200 متفاوت است، rule مربوط به variation را هم بررسی کنید.
چکلیست فنی
- HTML خام صفحه را با
curlذخیره کنید؛ متنهای مهم، canonical و فیلدهای JSON-LD را علامت بزنید. - خروجی View Source را با DOM پنل Elements بعد از JavaScript مقایسه کنید؛ فقط class یا event binding را نبینید، تفاوتهای محتوای قابلدیدن را جدا کنید.
- با غیرفعال کردن JavaScript تست کنید که اطلاعات لازم برای محصول، مقاله یا سرویس قابل خواندن هستند یا نه.
- هشدارهای کنسول React را با URL، component و نسخهٔ داده دنبال کنید؛
suppressHydrationWarningرا جایگزین اصلاح واقعی نکنید. - تاریخ، ساعت، locale و مقدار تصادفی را از render اول حذف کنید یا همان مقدار را از سرور به کلاینت منتقل کنید.
- در CDN و cache برنامه، جریان TTL، ETag، revalidation و purge را در لحظهٔ بهروزرسانی محتوا تأیید کنید.
سناریوی نمونه: قیمت محصول در SSR قدیمی است، اما در DOM بهروز
در یک صفحهٔ e-commerce، ERP قیمت محصول را به 1.249 TL بهروز میکند. اما بهدلیل TTL 300 ثانیهای CDN، سرور همچنان HTML شامل 1.299 TL را برمیگرداند. component React بعد از hydration یک درخواست API میزند و در مرورگر 1.249 TL نشان داده میشود. در حالی که کاربر در پنل Elements قیمت درست را میبیند، یک AI reader که JavaScript را اجرا نمیکند ممکن است در HTML خام هنوز 1.299 TL پیدا کند.
راهحل درست فقط بستن هشدار hydration نیست. باید مطمئن شوید SSR از منبع بهروز داده میگیرد، CDN بعد از بهروزرسانی ERP پاکسازی میشود و کلاینت همان مقدار اولیه را استفاده میکند. الگوی زیر کمک میکند که برچسب سرور در اولین render سمت کلاینت حفظ شود و بعد از رسیدن پاسخ 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 را ذخیره کنید، سپس DOM را در مرورگر دارای JavaScript ثبت کنید؛ بعد با diff -u فقط گره قیمت را نبینید، بلکه JSON-LD و متنهای دسترسپذیری را هم بررسی کنید.
اگر صفحه واقعاً دادهٔ متغیر را در کلاینت بهروزرسانی میکند، زمان انجام این بهروزرسانی را اندازه بگیرید. برای مثال fetchی که در 180 میلیثانیه تمام میشود ممکن است برای کاربر مرورگر قابل مشاهده باشد؛ اما agentی که اصلاً پاسخ سرور را render نمیکند، این زمان را تجربه نمیکند. از منظر AI readability، اطلاعات حیاتی باید در HTML اولیه وجود داشته باشد و مقدار آن با سیاست دادهٔ معتبر شما سازگار باشد.
اشتباهات رایج
- اینکه فکر کنیم پنهان کردن هشدار hydration، محتوای قدیمی یا ناقص را اصلاح میکند.
- فقط اسکرینشات را بررسی کنیم و اصلاً پاسخ خام HTTP را نگاه نکنیم.
- قیمت، موجودی یا بدنهٔ مقاله را فقط به API call داخل
useEffectبسپاریم. - در سرور و کلاینت از locale، timezone یا فرمت پول متفاوت استفاده کنیم.
- بدون تأیید پاکسازی cache در CDN، فرض کنیم بهروزرسانی محتوا فوراً منتشر شده است.
- رفتار یک bot مرورگر را به همهٔ AI agentها تعمیم بدهیم.
در نهایت، Hydration mismatch یک سیگنال است که باید اول خروجی SSR را با اولین render سمت کلاینت مقایسه کنید. برای فهمیدن اینکه آیا دادهٔ قدیمی واقعاً به AI bot میرسد یا نه، پاسخ خام، نمای بدون JavaScript، DOM زنده، logهای React و هدرهای cache را همگی روی یک URL واحد با هم ارزیابی کنید.