دانستنی‌های دنیای وب و زیرساخت

خطای پاسخ JSON نامعتبر وردپرس؛ چرا ذخیره و انتشار شکست می خورد؟

ویرایشگر به جای JSON چه چیزی دریافت کرده است؟ پس از حفظ نوشته، پاسخ واقعی درخواست را بررسی کنید و نشست، مسیر API، چالش امنیتی و خطای سرور را از هم جدا کنید.

نمای مفهومی ویرایش نوشته وردپرس و پاسخ نامعتبر هنگام ذخیره

روی انتشار می زنید و ویرایشگر می گوید «پاسخ، یک پاسخ JSON معتبر نیست». برای رفع خطای پاسخ JSON نامعتبر وردپرس، ابتدا متن را بیرون از مرورگر ذخیره کنید و بعد پاسخ واقعی درخواست ذخیره را ببینید. معمولا مسئله این است که ویرایشگر به جای داده مورد انتظار، محتوایی مانند صفحه ورود، چالش امنیتی، خطای سرور یا خروجی ناقص دریافت کرده است؛ خود جمله خطا، علت نهایی را مشخص نمی کند.

در این وضعیت، تازه کردن صفحه اولین قدم خوبی نیست. ممکن است آخرین تغییرها هنوز ذخیره نشده باشند. از طرف دیگر، گاهی درخواست روی سرور انجام شده ولی خواندن پاسخ در مرورگر شکست خورده است. پیش از ساخت نوشته دوم یا زدن چندباره انتشار، باید هر دو احتمال را بررسی کنید.

اول نوشته را حفظ کنید

عنوان، متن، پیوندها و بخش های مهم را در یک فایل محلی نگه دارید. اگر ویرایشگر گزینه کپی همه بلوک ها یا نمایش کد را در اختیارتان می گذارد، کپی مناسبی از ساختار هم بگیرید. تنها کپی متن ساده ممکن است تنظیم بلوک، چیدمان یا ارجاع بعضی رسانه ها را پوشش ندهد. اطلاعات حساس نوشته را در ابزار عمومی بررسی JSON نریزید.

پس از داشتن کپی، در یک تب جدا فهرست نوشته ها را بررسی کنید. زمان آخرین ویرایش، وضعیت نوشته و نسخه ذخیره شده را ببینید. اگر انتشار انجام شده، ساخت یک نسخه دیگر می تواند محتوای تکراری ایجاد کند. اگر ذخیره نشده، همان نسخه محلی مبنای بازیابی است؛ صفحه خطادار را تا زمان حفظ محتوا نبندید.

ویرایشگر چه پاسخی انتظار دارد؟

بخش های ویرایشگر برای خواندن و ذخیره محتوا از REST API وردپرس استفاده می کنند. در مرجع REST وردپرس، قالب پاسخ JSON است و خطاهای API هم می توانند همین قالب را داشته باشند. بنابراین یک پاسخ JSON با کد خطای روشن، با بدنه HTML که اصلا قابل خواندن به صورت JSON نیست تفاوت دارد.

مثلا اگر بدنه پاسخ با صفحه ورود شروع شده باشد، باید بفهمید چرا درخواست ذخیره به آنجا رسیده است. اگر پیام PHP پیش از داده چاپ شده، مشکل در خروجی سرور است. تغییر متن مقاله برای حل چنین پاسخ هایی، معمولا مسیر مناسبی نیست؛ مگر شواهد نشان دهد یک بخش مشخص از درخواست، قانون یا کد معیوبی را فعال می کند.

یک بار ذخیره را در Network دنبال کنید

ابزار توسعه دهنده مرورگر را باز کنید و در بخش Network، درخواست های Fetch/XHR را ببینید. پس از اطمینان از کپی محلی، یک بار عملیات ناموفق را انجام دهید. درخواست مرتبط با نوشته، رسانه یا عملیات همان لحظه را پیدا کنید؛ ممکن است چند درخواست هم زمان وجود داشته باشد و اولین ردیف قرمز، همان درخواست ذخیره نباشد.

URL، روش، کد پاسخ، مسیر انتقال احتمالی و متن Response را ثبت کنید. Content-Type سرنخ مفیدی است، ولی بدنه را هم بخوانید؛ یک هدر JSON با خروجی خراب همچنان مشکل دارد. در اشتراک گزارش، کوکی، nonce، متن خصوصی و اطلاعات حساب را حذف کنید. برای عیب یابی اولیه، ارائه رمز مدیریت لازم نیست.

پاسخ دیده شدهسرنخ اصلیمسیر بعدی
HTML صفحه ورودنشست یا انتقال به مسیر احراز هویتدامنه درخواست و وضعیت ورود
HTML چالش یا مسدودسازیلایه امنیتی به جای API پاسخ دادهرخداد WAF یا CDN مربوط به همان درخواست
JSON با rest_cookie_invalid_nonceاعتبار درخواست نشست تایید نشدهنشست، nonce و هماهنگی مبدا
404 یا انتقال به صفحه اصلیمسیر REST یا قواعد بازنویسیمقایسه مسیر واقعی API با تنظیم سایت
5xx، خروجی ناقص یا هشدار PHPاجرای سرور یا آلودگی بدنه پاسخلاگ همان دقیقه و تغییر اخیر

اگر پاسخ، صفحه ورود است

پس از حفظ نوشته، وضعیت ورود را در تب جدا بررسی کنید. نشستی که مدت زیادی باز مانده ممکن است دیگر برای ذخیره معتبر نباشد. همچنین دامنه و پروتکل درخواست را با محل باز بودن پیشخوان تطبیق دهید؛ تفاوت www، نشانی قدیمی پس از انتقال یا درخواست به مبدا دیگر می تواند بررسی نشست را پیچیده کند.

راهنمای احراز هویت REST توضیح می دهد که کوکی و nonce در درخواست های داخل وردپرس نقش دارند. nonce جای مجوز کاربر را نمی گیرد و حذف کنترل آن، راه حل مشکل نیست. با تجدید نشست از روش معمول ورود، دوباره یک پیش نویس آزمایشی را ذخیره کنید؛ توکن را دستی از جایی کپی نکنید تا صرفا خطا ناپدید شود.

برای کد یا افزونه سفارشی، مستندات api-fetch وردپرس درباره ارسال درخواست با ریشه API و اطلاعات نشست همان سایت توضیح می دهد. درخواست به دامنه دیگری را با ابزار و nonce سایت فعلی یکی نگیرید. توسعه دهنده باید مبدا درست و روش احراز هویت مناسب را اصلاح کند، نه اینکه خطا را در رابط کاربری پنهان کند.

مقایسه پاسخ JSON با صفحه ورود، چالش امنیتی و خطای سرور
کد پاسخ و بدنه دریافتی، مسیر تشخیص مشکل ذخیره را مشخص می کنند.

وقتی CDN یا ابزار امنیتی HTML می فرستد

درخواست مرورگر و دریافت کننده API همیشه نمی توانند مثل یک بازدیدکننده صفحه چالش را طی کنند. اگر Response متن چالش دارد، شناسه رخداد و زمان را با لاگ ابزار امنیتی تطبیق دهید. وجود نام یک CDN در هدر به تنهایی دلیل کافی برای مقصر دانستن آن نیست؛ پاسخ سرور مبدا هم ممکن است از همان شبکه گذشته باشد.

در Cloudflare، راهنمای تشخیص پاسخ Challenge هدر cf-mitigated با مقدار challenge و نوع محتوای text/html را برای این پاسخ توضیح می دهد. اگر چنین شواهدی وجود دارد، مسئول امنیت باید قانون مربوط به مسیر و روش درخواست را بررسی کند.

از کار انداختن همه قوانین یا اجازه عمومی به کل wp-json، اصلاح محدودی نیست. بعضی مسیرهای REST اطلاعات عمومی می دهند و بعضی نیازمند مجوز اند. استثنا باید با هدف قانون و هویت معتبر درخواست هماهنگ شود. پس از تغییر، هم ذخیره مجاز و هم باقی ماندن محدودیت لازم را بررسی کنید.

مسیر REST را از مشکل انتشار جدا آزمایش کنید

روی نصب معمول، ریشه API اغلب از نشانی زیر در دسترس است. example.com را با دامنه واقعی و مسیر نصب جایگزین کنید. نمونه دوم برای مقایسه مسیر پرس و جو است؛ قرار نیست بدون بررسی، آن را به تنظیم دائمی سایت تبدیل کنید.

https://example.com/wp-json/
https://example.com/?rest_route=/

مستندات کشف REST API تفاوت این نشانی ها را با توجه به ساختار پیوند توضیح می دهد. اگر یکی JSON مناسب می دهد و دیگری HTML یا 404، مسیر بازنویسی و قواعد وب سرور باید بررسی شوند. ذخیره پیوندهای یکتا بدون تغییر ساختار می تواند در بررسی قواعد مطرح باشد؛ آدرس همه نوشته ها را برای آزمون عوض نکنید.

باز شدن wp-json یعنی انتشار حتما سالم است؟

خیر. خواندن فهرست عمومی API با ذخیره نوشته دارای مجوز یک کار واحد نیست. روش درخواست، مسیر، داده و احراز هویت تفاوت دارند. نتیجه این آزمون فقط دامنه بررسی را کوچک می کند و جای دیدن درخواست ناموفق انتشار را نمی گیرد.

خطا فقط با یک محتوا یا بعد از یک تغییر رخ می دهد

یک پیش نویس کوتاه و غیرحساس را جدا آزمایش کنید. اگر آن ذخیره می شود، محتوای اصلی، بلوک های خاص و امکانات افزونه ها را در کپی آزمایشی مقایسه کنید. بخش ها را با حفظ نسخه اصلی محدود کنید تا محرک مشخص شود؛ حذف دائمی نیمی از مقاله فقط برای گرفتن پیام موفقیت، هدف عیب یابی نیست.

اگر مشکل بعد از نصب افزونه، تغییر قالب، انتقال یا ارتقای PHP شروع شده، همان تغییر را با لاگ مرتبط بررسی کنید. پیش از دستکاری فایل و تنظیمات بکاپ بگیرید. خاموش کردن گروهی افزونه ها روی سایت زنده می تواند فرم، خرید یا امکانات کاربر را متوقف کند؛ آزمون تداخل گسترده را در محیط آزمایشی انجام دهید.

هشدار PHP، خروجی debug، فضای ناخواسته یا قطع شدن پاسخ در زمان اجرا باید از منبع اصلاح شود. خطاها را به بدنه عمومی API نفرستید؛ ثبت امن لاگ امکان بررسی را حفظ می کند. در محیط هاست لینوکس وردپرس، دسترسی به لاگ و شناخت محدودیت اجرا برای همین بررسی اهمیت دارد.

تغییر به ویرایشگر کلاسیک، مشکل را حل می کند؟

ممکن است مسیر متفاوتی را به کار بگیرد و نشانه دیده نشود، اما علت پاسخ نامعتبر REST را ثابت یا اصلاح نمی کند. این تغییر می تواند بر بلوک ها و روند تیم اثر بگذارد. REST را غیرفعال نکنید و اعتبارسنجی HTTPS را برای عبور موقت کنار نگذارید.

ذخیره موفق را تا نتیجه قابل مشاهده دنبال کنید

پس از اصلاح، یک پیش نویس آزمایشی را ذخیره، از صفحه خارج و دوباره باز کنید. متن و وضعیت ذخیره شده باید با انتظار شما بخواند. سپس همان سناریوی اصلی، مانند ذخیره بلوک یا انتشار زمان دار، بررسی شود. موفقیت یک درخواست خواندنی، پایان کار انتشار نیست.

اگر به پشتیبانی فنی سایت نیاز دارید، زمان، URL درخواست، کد و نمونه پاک سازی شده پاسخ را بفرستید. این گزارش از عبارت کلی «وردپرس انتشار نمی دهد» دقیق تر است و کمک می کند علت میان نشست، مسیر REST، امنیت و اجرای سرور گم نشود.

از مطالعه تا اجرا

سرویس‌های مرتبط با این مطلب

برای بررسی راهکار مناسب، مشخصات و شرایط این خدمات را ببینید.

میزبانی لینوکس ایران

هاست لینوکس ایران را برای سایت وردپرسی، شرکتی یا فروشگاهی خود بررسی کنید. فضای دیسک، پایگاه داده و منابع پلن را با نیاز سایت تطبیق دهید و سازگاری نسخه PHP و افزونه‌ها را پیش از انتقال مشخص کنید.

بررسی سرویس
نظر شما مهم است

این مطلب چقدر برایتان مفید بود؟

اولین نفری باشید که به این مطلب امتیاز می‌دهد.

ادامه گفت‌وگو

این مطلب را به اشتراک بگذارید

اگر برایتان مفید بود، آن را برای همکاران و دوستانتان بفرستید.

تجربه شما، ادامه این مطلب

پرسش‌ها و دیدگاه‌های شما

سؤال یا تجربه مرتبط با این مطلب دارید؟ با ما و خوانندگان مجله آفاق هاست در میان بگذارید.

دیدگاهتان را بنویسید

دیدگاه‌ها پس از بررسی منتشر می‌شوند. لطفاً پرسش یا تجربه مرتبط با همین مطلب را بنویسید.

برای ادامه مطالعه
همه مطالب مجله
قدم بعدی را با هم برداریم

برای شروع، یک گفت‌وگو کافی‌ست.

از انتخاب سرور تا ساخت وب‌سایت، مسیر مناسب کسب‌وکارتان را پیدا کنیم.

تماس با آفاق هاست 021-91092061