چگونه خطای JSON رو در وردپرس رفع کنیم

یکی از مشکلات رایجی که ممکن است هنگام ویرایش پست‌ها یا صفحات در وردپرس با آن مواجه شوید، خطای “پاسخ یک پاسخ JSON معتبر نیست” یا “Not a Valid JSON Response” است. این خطا می‌تواند باعث شود که عملیات به‌روزرسانی پست‌ها یا صفحات وردپرس با شکست مواجه شود. در این مقاله از وب آنجل، قصد داریم دلایل بروز این خطا را بررسی کرده و روش‌های رفع آن را آموزش دهیم.

چه عواملی باعث بروز خطای “پاسخ نامعتبر JSON” در وردپرس می‌شوند؟

این خطا معمولاً زمانی اتفاق می‌افتد که وردپرس نتواند پاسخ مورد انتظار را از سرور دریافت کند. در واقع، هنگام ویرایش یک پست یا صفحه در وردپرس، این پلتفرم نیاز به برقراری ارتباط با سرور دارد تا اطلاعات مورد نیاز را به‌روزرسانی کند. این ارتباط معمولاً با استفاده از JSON (JavaScript Object Notation) انجام می‌شود که یک فرمت داده‌ای سبک و قابل‌انتقال برای تبادل اطلاعات است.

دلایل اصلی بروز این خطا عبارتند از:

1. مشکلات مربوط به تنظیمات سرور (Server Configuration): اگر تنظیمات سرور به‌درستی پیکربندی نشده باشد یا محدودیت‌های خاصی روی درخواست‌ها اعمال شده باشد (مانند محدودیت‌های مربوط به فایروال یا محدودیت‌های PHP)، ممکن است درخواست‌های JSON از سرور دریافت نشوند.
2. استفاده از پروتکل HTTP به‌جای HTTPS: اگر سایت شما از HTTPS استفاده نمی‌کند یا مشکلات مربوط به SSL وجود دارد، این می‌تواند باعث ایجاد خطا در ارسال درخواست‌های JSON شود.
3. مشکلات کش (Caching): گاهی اوقات کش مرورگر یا کش سرور می‌تواند مانع از دریافت پاسخ صحیح از سرور شود، به‌ویژه اگر کش‌های قدیمی باعث بروز مشکل در پاسخ‌دهی به درخواست‌ها شوند.
4. عدم تطابق نسخه‌های وردپرس و پلاگین‌ها: گاهی اوقات پلاگین‌ها یا قالب‌های قدیمی یا ناسازگار با نسخه جدید وردپرس می‌توانند باعث بروز مشکلات در ارسال و دریافت پاسخ‌های JSON شوند.
5. مشکلات در فایل .htaccess: تنظیمات اشتباه یا ناسازگار در فایل .htaccess ممکن است باعث مسدود شدن درخواست‌های API یا ارسال پاسخ‌های نامعتبر شود.

اگر به هر دلیلی این پاسخ از سرور به‌درستی ارسال نشود، یا سرور نتواند پاسخ مناسب را در قالب JSON ارسال کند، این خطا مشاهده خواهد شد.

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

نکته مهم: لطفاً قبل از ایجاد هرگونه تغییر بزرگ در وب سایت خود، از نسخه پشتیبان کامل وردپرس استفاده کنین. با این کار می تونین وب سایت خود رو به راحتی به حالت قبلی برگردونین.

1. URL های وردپرس رو در تنظیمات بررسی کنین

ابتدا باید از درست بودن تنظیمات آدرس وردپرس و آدرس سایت خود اطمینان حاصل کنین. به سادگی، به صفحه Settings>> General برین. از اینجا، باید قسمت های آدرس وردپرس (URL) و آدرس سایت آن رو مرور کنین.

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

اگه در تنظیمات تغییری ایجاد کردین، فراموش نکنین که برای ذخیره تنظیمات خود بر روی دکمه Save Changes کلیک کنین. اکنون می تونین یک پست وبلاگ رو ویرایش کرده و ببینین آیا افزودن بلوک های جدید یا ذخیره آن پست باعث خطای “عدم پاسخ معتبرJSON ” میشه. اگه هنوز خطا رو مشاهده می کنین، به خواندن ادامه بدین.

2. ساختار پیوند ثابت وردپرس رو درست کنین

وردپرس دارای ساختار URL دوستانه SEO است که به شما امکان میده از URL های قابل خواندن توسط انسان برای پست ها و صفحات خود استفاده کنین. با این حال، گاهی اوقات ممکنه کاربر تنظیمات پیوندهای ثابت رو بهم بریزه. این امر باعث میشه ویرایشگر وردپرس پاسخ JSON معتبر رو دریافت کنه و خطا رو نشان بده. برای رفع این مشکل، باید به سادگی به صفحه Settings>> Permalinks مراجعه کنین. از اینجا، باید گزینه های پیوند ثابت رو به دقت بررسی کنین.

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

3. بازسازی فایل وردپرس htaccess

فایل htaccess در وردپرس به عنوان یک فایل پیکربندی برای مدیریت URL های دوستانه SEO (پیوندهای ثابت) استفاده میشه. به طور معمول، وردپرس می تونه به طور خودکار آن رو بازسازی و به روز کنه. همچنین می تونین با کلیک روی دکمه Save Changes در پایین صفحه Settings>>Permalinks، به روزرسانی رو فعال کنین. با این حال، گاهی اوقات ممکنه به روز رسانی انجام نشه یا تنظیمات نادرستی داشته باشه.

این امر بر روی لینک های ثابت وردپرس شما تأثیر میذاره و همچنین ممکنه باعث خطای پاسخ نامعتبر JSON بشه. برای رفع این مشکل، باید با استفاده از سرویس گیرنده FTP یا برنامه مدیریت پرونده در داشبورد حساب هاست وردپرس به وب سایت خود متصل بشین. پس از اتصال، باید فایل htaccess رو در پوشه اصلی وب سایت خود قرار داده و به عنوان پشتیبان در رایانه بارگیری کنین.

پس از آن، باید فایل htaccess رو با استفاده از سرویس گیرنده FTP یا برنامه مدیر پرونده ویرایش کنین.

پس از باز شدن پرونده، باید تمام کدهای داخل آن رو حذف کرده و کد زیر رو جایگزین کنین:

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

4. مشاهده ورود به سیستم رفع اشکال در API

خطای پاسخ نامعتبر JSON به این معنیه که WordPress REST API در وب سایت شما با خطایی روبرو شده است. REST API مجموعه تکنیک هایی است که وردپرس هنگام کار در وب سایت شما برای برقراری ارتباط با سرور استفاده می کنه. جزئیات این خطا رو می تونین در ابزار WordPress Site Health مشاهده کنین. از صفحه Tools>> Site Health بازدید کنین.

در اینجا ممکنه مشکلی با عنوان “The Rest API encountered an unexpected results” رو مشاهده کنین. با کلیک بر روی آن جزئیات بیشتری به شما نشان داده میشه که ممکنه به شما سرنخی بده تا بفهمین کدام یک از پلاگین ها یا سرویس های شخص ثالث می تونن باعث بروز این مشکل بشن. اگه این بخش هیچ سرنخی ارائه نکرد، می تونین به مرحله بعدی برین.

5. غیرفعال سازی تمام پلاگین های وردپرس

گاهی اوقات، ممکنه پلاگین های وردپرس با یکدیگه یا هسته وردپرس مغایرت داشته باشن. این امر می تونه منجر به یک رفتار غیر منتظره بشه و می تونه دلیل بالقوه خطای JSON نامعتبر باشه. نگران نباشین، به صفحه Plugins>> Installed Plugins برین. از اینجا، همه پلاگین های وردپرس خود رو انتخاب کرده و سپس “Deactivate” رو از فهرست کشویی Bulk Actions انتخاب کنین. اکنون، برای ادامه بر روی دکمه Apply کلیک کنین.

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

6. به طور موقت به ویرایشگر Classic برید

اگه تمام مراحل بالا شکست خورد، می تونین به طور موقت به ویرایشگر Classic برای وردپرس برین. این نسخه قدیمی ویرایشگر وردپرس از ویرایشگر متن ساده تری استفاده می کنه و برای دریافت پاسخ JSON زیاد به REST API اعتماد نمی کنه. برای استفاده از آن، باید پلاگین Classic Editor رو نصب و فعال کنین. این پلاگین خارج از باکس کار می کنه و هنگام فعال سازی، ویرایشگر Gutenberg رو غیرفعال می کنه. اکنون می تونین در وب سایت خود کار کنین و بعداً به عیب یابی بپردازین.

7. عیب یابی بیشتر

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

تغییر به یک قالب پیش فرض وردپرس:

بعضی اوقات ممکنه درگیری بین قالب وردپرس و یک پلاگین یا هسته وردپرس منجر به یک رفتار غیر منتظره بشه. شما می تونین این کار رو به سادگی با رفتن به یک قالب پیش فرض وردپرس مانند TwentyTwentyOne یا Twenty-Twenty، آزمایش کنین.

فایروال برنامه سایت رو به طور موقت خاموش کنین:

اگه از فایروال وردپرس مانند Sucuri ،Cloudflare یا پلاگین استفاده می کنین، ممکنه گاهی اوقات درخواست های مشکوک رو نیز مسدود کنن. ساده ترین راه برای کشف این مسئله غیرفعال کردن موقت پلاگین یا سرویس فایروال وردپرس است. برخی از فایروال های وردپرس در سطح برنامه رو می توان با غیرفعال کردن ساده پلاگین، غیرفعال کرد. برای فایروال های سطح DNS مانند Sucuri و Cloudflare، می تونین آن ها رو از داشبورد حساب خود غیرفعال کنین.

اشکال زدایی “Debugging” رو در وردپرس روشن کنین

وردپرس دارای یک ویژگی داخلی است که به شما امکان میده سوابقی از خطاها رو ثبت کنین. با این حال، به طور پیش فرض فعال نیست. برای روشن کردن آن، باید کد زیر رو به فایل wp-config.php خود اضافه کنین:

;define(‘WP_DEBUG’, true)

;define(‘WP_DEBUG_LOG’, true)

پس از آن، وردپرس ثبت تمام خطاها رو در یک فایل debug.log واقع در پوشه /wp- content/ ذخیره می کنه. با استفاده از سرویس گیرنده FTP می تونین به این فایل دسترسی پیدا کنین. گزارش خطا ممکنه سرنخی در مورد آنچه احتمالاً باعث ایجاد خطای JSON نامعتبر در وب سایت شما شده رو به شما ارائه بده.

به دنبال کمک متخصص باشین

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

سوالات متداول درباره خطاهای JSON در وردپرس