پیام «پاسخ، یک پاسخ JSON معتبر نیست» معمولاً یعنی ویرایشگر انتظار دادهٔ JSON داشته، اما پاسخ دریافتی با آن سازگار نبوده است. ممکن است بهجای JSON، صفحهٔ ورود، خطای HTML یا خروجی هشدار PHP رسیده باشد. راه تشخیص، دیدن درخواست شکستخورده و محتوای پاسخ آن است؛ تغییر فوری پیوند یکتا یا غیرفعالکردن همهٔ افزونهها اطلاعات اصلی خطا را پنهان میکند.
۱. متن ذخیرهنشده را حفظ کنید
پیش از بازخوانی صفحه، متن و تغییرات ذخیرهنشده را در یک محل خصوصیِ مجاز نگه دارید. صفحهٔ ورود یا تازهکردن نشست ممکن است لازم شود، ولی نباید با ازدسترفتن متن همراه باشد. یک تلاش کنترلشده برای ذخیره کافی است؛ تلاشهای پیدرپی بدون مشاهدهٔ نتیجه کمکی به تشخیص نمیکنند.
نکته: نام دقیق پیام به زبان و نسخهٔ ویرایشگر بستگی دارد. این مقاله خطای واقعی روی سایت ایجاد نمیکند و تصویر خطای ساختگی هم ارائه نمیدهد.
۲. پاسخ را در ابزار مرورگر بررسی کنید
- ابزار توسعهٔ مرورگر را باز کنید و در بخش Network، درخواستهای Fetch/XHR را ببینید.
- همزمان با یک ذخیرهٔ مجاز، درخواست مرتبط با نوشته و مسیر REST را پیدا کنید؛ وجود wp-json در مسیر یک سرنخ است.
- Method، Status، نوع محتوا و متن Response همان درخواست را بخوانید. صرف دیدن خطای قرمز Console کافی نیست.
- اگر پیام ورود یا محدودیت دسترسی میبینید، اطلاعات همان مسیر را دنبال کنید؛ برای یک خطای نحوی JSON، تنظیمات امنیت را خاموش نکنید.
فایل کامل HAR، بخش Request Headers و نشانیهای دارای nonce میتوانند اطلاعات نشست داشته باشند. برای گزارش، فقط کد وضعیت، مسیر بدون پارامتر محرمانه و بخش کوتاهِ پاکسازیشدهٔ پاسخ کافی است.
۳. چه پاسخی به کدام شاخه میرود؟
| پاسخ واقعی | تفسیر و بررسی |
|---|---|
200 + صفحهٔ ورود HTML |
تفسیر اولیه: وضعیت HTTP موفق، اما دادهٔ نامناسباقدام بعد: نشست و مسیر redirect بررسی شود |
403 + JSON با code مشخص |
تفسیر اولیه: JSON معتبر، ولی خطای دسترسیاقدام بعد: کد خطا و روش احراز هویت بررسی شود |
404 + HTML |
تفسیر اولیه: مسیر یا لایهٔ مسیریابی اقدام بعد: URL درخواست و محل ایجاد404 مشخص شود |
500 + Warning یا HTML |
تفسیر اولیه: خطای سمت سرور و آلودگی خروجی اقدام بعد: لاگ همان زمان بررسی شود |
200 + JSON سالم |
تفسیر اولیه: پارسر عمومی میتواند بخواند اقدام بعد: ساختار مورد انتظار ویرایشگر هم بررسی شود |
طبق قرارداد JSON.parse، HTML و متن اضافه پیش از JSON قابل تجزیه به JSON نیستند. بااینحال، JSON معتبر هم ممکن است دادهٔ مورد انتظار برنامه نباشد. کد ۲۰۰ بهتنهایی صحت قالب یا ذخیرهٔ نوشته را ثابت نمیکند.
۴. مثال روشن از تفاوت قالبها
{"saved":true,"id":42}
این یک شیء JSON معتبر و صرفاً نمونهٔ آموزشی است؛ پاسخ واقعی WordPress را بازسازی نمیکند. دو ورودی زیر JSON معتبر نیستند:
<!doctype html><title>Login</title>
Warning: demo only
{"saved":true}
در آزمون محلی، شیء اول خوانده شد و دو نمونهٔ HTML و Warning خطای parse دادند. این آزمون فقط تفاوت قالب را نشان میدهد؛ ثابت نمیکند علت خطای سایت شما PHP است. متن Warning را با حذف ظاهری پیام اصلاح نکنید؛ تولیدکنندهٔ خروجی باید مشخص شود.
۵. سلامت REST را بهعنوان سرنخ بخوانید

از ابزارها ← سلامت سایت، آزمون REST API را بررسی کنید. کد رسمی آزمون سلامت REST نشان میدهد این یک درخواست مشخص با شرایط مشخص است. نتیجهٔ سالم، همهٔ مسیرهای افزونهها، نقشهای کاربری و عملیات ذخیره را پوشش نمیدهد. نتیجهٔ ناموفق هم باید با پاسخ همان درخواست و لاگ مرتبط تفسیر شود.
۶. اصلاح را محدود و قابل بازگشت نگه دارید
اگر ورود منقضی شده، پس از حفظ متن دوباره وارد شوید و یک ذخیرهٔ کنترلشده را بررسی کنید. اگر HTML یا خطای سرور برمیگردد، زمان و شناسهٔ درخواست را برای پشتیبانی بفرستید. آزمون تعارض افزونه یا تغییر قواعد مسیریابی را در محیط آزمایشیِ دارای بکاپ انجام دهید؛ برای صرفاً خواندن این خطا نیازی به تغییر زندهٔ فایلها نیست.
از کجا بدانیم مشکل رفع شده؟
درخواست ذخیره باید پاسخ قابلانتظار بدهد و پس از بازکردن دوبارهٔ نوشته، همان تغییر واقعاً ثبت شده باشد. ناپدیدشدن پیام قرمز بهتنهایی کافی نیست.
آیا پاککردن کش همیشه کافی است؟
خیر. کش فقط یکی از لایههای ممکن است. اگر پاسخ صفحهٔ ورود یا خطای PHP باشد، باید همان علت را پیگیری کنید.
اگر علاوه بر خطای JSON، آزمون Loopback در سلامت سایت هم ناموفق است، راهنمای عیبیابی Loopback وردپرس کمک میکند مشکل درخواست داخلی را جدا از پاسخ REST بررسی کنید.
۷. مسیر مطالعهٔ مرتبط
۸. منابع و دامنهٔ بررسی
منابع رسمی در ۳ نوامبر ۲۰۲۶ بررسی شدند. تصاویر سلامت سایت از وردپرس ۷.۱.۴ در ۳ نوامبر ۲۰۲۶ ثبت شدهاند. کارت سالم، شاهد رفع یک خطای فرضی نیست. هیچ افزونه، تنظیم حفاظتی یا فایل سایت برای آزمایش تغییر نکرده است. آزمایشهای دادهٔ نمونه محلیاند؛ نتیجهٔ آنها سلامت همهٔ درخواستهای سایت را ثابت نمیکند.