همه مقالات تخصصی

خطای REST API و loopback در Site Health وردپرس: علت و رفع

هشدار REST API encountered an error و loopback request failed را با wp_remote_get و curl از خود سرور ردیابی کنید و علت‌های رایج مثل فایروال و DNS داخلی را بشناسید.

خطای REST API و loopback در Site Health وردپرس: علت و رفع

ابزار Site Health وردپرس گاهی می‌گوید REST API خطا داده یا loopback شکست خورده است. یعنی سرور نمی‌تواند به آدرس خودش درخواست بزند. این روی کران‌جاب‌ها، به‌روزرسانی‌ها و بعضی افزونه‌ها اثر می‌گذارد. این راهنما راه دقیق پیداکردن علت را می‌گوید.

۱. مشکل را از خود سرور بسازید

wp eval 'var_dump( wp_remote_get( home_url( "/wp-json/" ) ) );'

خروجی اگر WP_Error باشد پیام دقیق (مثل cURL error 28 timeout یا 60 مشکل گواهی) را می‌بینید؛ اگر آرایه باشد، کد پاسخ را بخوانید. این همان درخواستی است که Site Health انجام می‌دهد.

۲. با curl از داخل سرور

curl -sI https://example.com/wp-json/ | head -n 5
getent hosts example.com

اگر curl هم شکست خورد، مشکل وردپرس نیست و از شبکه یا وب‌سرور است. با getent ببینید دامنه از داخل سرور به چه IP می‌رسد؛ گاهی به IP عمومی می‌رسد که فایروال اجازهٔ برگشت به خودش را نمی‌دهد.

۳. علت‌های رایج

  • فایروال یا سیاست NAT که اتصال سرور به IP عمومی خودش را قطع می‌کند.
  • Basic Auth یا محدودیت IP روی کل سایت یا روی wp-json.
  • افزونهٔ امنیتی که REST را برای کاربر ناشناس می‌بندد.
  • Cloudflare یا WAF که درخواست‌های سرور را چالش می‌دهد.
  • گواهی نامعتبر یا زنجیرهٔ ناقص.

۴. راه‌حل‌ها

در صورت مشکل DNS داخلی، یک ورودی در /etc/hosts که دامنه را به 127.0.0.1 ببرد، درخواست را محلی می‌کند (فقط اگر وب‌سرور همان ماشین است). برای حالت IP را در لیست مجاز بگذارید. WP-Cron هم به همین loopback وابسته است. برای مشکل گواهی، بخش TLS در تنظیم TLS را ببینید.

۵. تأیید

Site Health را دوباره اجرا کنید و با wp cron event run --due-now اطمینان بگیرید کران‌جاب‌ها اجرا می‌شوند.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید Site Health خطای loopback می‌داد. wp eval نشان داد cURL error 28 رخ می‌دهد و getent دامنه را به IP عمومی برمی‌گرداند که فایروال ارتباط داخلی را رد می‌کرد. افزودن ورودی hosts مشکل را برطرف کرد. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • غیرفعال‌کردن REST API به‌جای پیداکردن علت.
  • نادیده‌گرفتن هشدار و ازدست‌دادن کران‌جاب‌ها.
  • تست فقط از مرورگر خود (که از شبکهٔ دیگری است).
  • تغییر /etc/hosts بدون دانستن اینکه وب‌سرور همان ماشین است.

۸. پرسش‌های متداول

loopback یعنی چه؟ درخواست سرور به آدرس عمومی خودش.

از مرورگر باز می‌شود، چرا هشدار می‌دهد؟ مسیر سرور به خودش با مسیر مرورگر متفاوت است.

آیا REST API را ببندم؟ نه؛ ویرایشگر بلوکی و بسیاری از افزونه‌ها به آن نیاز دارند.

۹. چک‌لیست سریع

  1. wp_remote_get از سرور اجرا شد.
  2. curl از سرور تست شد.
  3. DNS داخلی بررسی شد.
  4. فایروال/WAF و Basic Auth بررسی شد.
  5. Site Health و کران‌جاب دوباره تأیید شد.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

WordPress: wp_remote_get() · WordPress REST API handbook · WordPress: Site Health