مستندات / عیب‌یابی

عیب‌یابی

سلامت سیستم، لاگ، خطاهای رایج و چک‌لیست.

ویدیو آموزشی

آموزش تصویری بخش «عیب‌یابی»

در حال ضبط و جمع‌آوری ویدیو

نسخه ویدیویی این آموزش پس از آماده‌شدن در همین قسمت نمایش داده می‌شود.

نقطه شروع ثابت در پیشخوان وردپرس منوی دربان را باز کنید و وارد بخش «عیب‌یابی» شوید. کارت «سلامت سامانه» وضعیت کانال‌های ارسال، بله، ایمیل، برگه ورود، ووکامرس، کپچا، ورود گوگل و وابستگی‌های افزودنی‌ها را نشان می‌دهد. مورد قرمز را پیش از مورد نارنجی برطرف کنید.

۱) لایسنس فعال نمی‌شود

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

۲) منوی دربان نمایش داده نمی‌شود

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

۳) کد یک‌بارمصرف نمی‌رسد

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

۴) پترن پیامک رد می‌شود یا کد داخل پیام نیست

  • نشانه: پنل پیامکی درخواست را رد می‌کند، متن می‌رسد ولی کد خالی است یا ارسال ساده کار می‌کند اما ارسال پترن نه.
  • چه بررسی شود: شناسه پترن متعلق به همان حساب و تأییدشده باشد. نام متغیر باید دقیقاً مطابق سرویس باشد؛ برای SMS.ir مقدار CODE، برای قاصدک مقدار %Code%، برای فراز اس‌ام‌اس مقدار %code% و برای پیام‌رسان جای کد {1} است. در کاوه‌نگار نام قالب را وارد کنید.
  • راه حل: پترن را در پنل سرویس‌دهنده با نام متغیر درست اصلاح و تأیید کنید، شناسه آن را دوباره در «کانال‌های ارسال» ذخیره کنید و ارسال آزمایشی بگیرید. برای اعلان سفارش، متن نمونه ساخته‌شده در کارت همان قانون و ترتیب متغیرهای آن را عیناً مبنا قرار دهید.
ارسال ساده در سرویس‌هایی که حالت متن ساده دارند، خط فرستنده و متن فقط وقتی استفاده می‌شوند که شناسه پترن خالی باشد. پر بودن شناسه ناقص یا اشتباه باعث نمی‌شود افزونه خودکار به متن ساده برگردد.

۵) پیامک پشتیبان عمل نمی‌کند

  • نشانه: سرویس اصلی ناموفق است و با وجود روشن بودن پیامک پشتیبان، پیام از سرویس دوم نمی‌رسد.
  • چه بررسی شود: سرویس پشتیبان باید با سرویس اصلی متفاوت باشد و اطلاعات ورود و پترن هر دو سرویس کامل ذخیره شده باشد. مسیر پشتیبان فقط پس از ناموفق شدن تلاش اصلی یک‌بار اجرا می‌شود.
  • راه حل: در منوی دربان وارد «کانال‌های ارسال» شوید، «فعال‌سازی پیامک پشتیبان» را روشن کنید، سرویس دوم را انتخاب کنید و فیلدهای نمایش‌داده‌شده آن را کامل کنید. با ایجاد یک خطای کنترل‌شده در سرویس اصلی، پیام آزمایش باید اعلام کند ارسال از مسیر پشتیبان انجام شده است.

۶) کد ایمیلی نمی‌رسد

  • نشانه: کانال ایمیل روشن است اما کاربر در ورود یا بازیابی رمز ایمیلی دریافت نمی‌کند.
  • چه بررسی شود: ایمیل فقط برای ورود و بازیابی رمز استفاده می‌شود و در ثبت‌نام کاربرد ندارد. حساب صاحب شماره باید ایمیل معتبر داشته باشد و ارسال ایمیل سایت یا SMTP سالم باشد.
  • راه حل: در «کانال‌های ارسال» یک نشانی واقعی وارد کنید و «ارسال ایمیل آزمایشی» را بزنید. اگر آزمایش شکست خورد تنظیمات SMTP و تحویل ایمیل هاست را اصلاح کنید؛ اگر آزمایش موفق بود، ایمیل حساب کاربر و پوشه هرزنامه او را بررسی کنید.

۷) ارسال در بله انجام نمی‌شود

  • نشانه: بله روشن است اما در سلامت سامانه «پیکربندی نشده» دیده می‌شود یا آزمایش بله خطا می‌دهد.
  • چه بررسی شود: کلید دسترسی و شناسه عددی بات هر دو وارد شده باشند. گیرنده باید کاربر بله باشد و حساب بله اعتبار و ظرفیت ارسال داشته باشد.
  • راه حل: اطلاعات سرویس سفیر را در «کانال‌های ارسال» دوباره وارد و ذخیره کنید، سپس «ارسال آزمایشی در بله» را بزنید. خطای گیرنده نامعتبر یا عضو نبودن در بله با تغییر تنظیمات سایت حل نمی‌شود؛ شماره دیگری را آزمایش کنید.

۸) کپچا فرم را متوقف می‌کند

  • نشانه: دکمه ارسال واکنش کامل ندارد، پیام تکمیل چالش دیده می‌شود یا reCAPTCHA در صفحه بارگذاری نمی‌شود.
  • چه بررسی شود: حالت کپچا، کلیدهای reCAPTCHA، دامنه مجاز ثبت‌شده نزد گوگل، دسترسی سرور و مرورگر به سرویس گوگل و تداخل مسدودکننده تبلیغات را کنترل کنید.
  • راه حل: در منوی دربان وارد «امنیت» شوید. برای تشخیص، موقتاً یکی از کپچاهای داخلی متنی یا تعاملی را انتخاب کنید. اگر فرم درست شد، کلیدها و دامنه reCAPTCHA را اصلاح کنید و سپس دوباره حالت گوگل را فعال کنید. بدون کپچا گذاشتن فرم راه حل دائمی نیست.

۹) ورود با گوگل شکست می‌خورد یا شماره ندارد

  • نشانه: پس از انتخاب حساب گوگل، کاربر با خطای عمومی به صفحه ورود برمی‌گردد؛ یا وارد می‌شود ولی در تسویه‌حساب باید شماره را تأیید کند.
  • چه بررسی شود: شناسه و رمز برنامه گوگل کامل باشند و نشانی بازگشت ثبت‌شده در کنسول گوگل دقیقاً با نشانی اعلام‌شده در تنظیمات دربان یکسان باشد. ورود گوگل شماره موبایل تأییدشده ایجاد نمی‌کند.
  • راه حل: اطلاعات برنامه و نشانی بازگشت را اصلاح کنید و دوباره ورود بگیرید. درخواست تأیید شماره در تسویه‌حساب برای کاربر گوگل رفتار درست افزونه است؛ کاربر باید همان‌جا شماره را وارد و کد را تأیید کند.

۱۰) ورود یا تأیید ووکامرس درست کار نمی‌کند

  • نشانه: فرم قدیمی ووکامرس دیده می‌شود، فیلد موبایل ذخیره نمی‌شود، مهمان بدون تأیید سفارش می‌گذارد یا پس از ورود به سبد برنمی‌گردد.
  • چه بررسی شود: ووکامرس فعال باشد. در سلامت سامانه وضعیت همگام‌سازی ووکامرس را ببینید. در تنظیمات دربان، «همگام‌سازی ورود ووکامرس»، «تأیید شماره پیش از ثبت سفارش»، «الزام ورود» و مقصد پس از ورود را متناسب با هدف خود کنترل کنید.
  • راه حل: گزینه لازم را ذخیره کنید، کش را پاک کنید و یک خرید تازه در پنجره خصوصی انجام دهید. برای بازگشت عادی به تسویه‌حساب، مقصد اختصاصی پس از ورود را خالی بگذارید. فیلد موبایل دربان را با تلفن صورتحساب ووکامرس اشتباه نگیرید.

۱۱) اعلان سفارش ارسال نمی‌شود

  • نشانه: کد ورود پیامکی می‌رسد اما ثبت سفارش یا تغییر وضعیت هیچ پیامی برای مشتری یا مدیر ندارد.
  • چه بررسی شود: فعال‌سازی کلی اعلان‌ها، قانون وضعیت موردنظر، مخاطب «به مشتری» یا «به مدیران»، شناسه پترن و ترتیب متغیرها را بررسی کنید. برای مدیر باید دست‌کم یک شماره مدیر ثبت شده باشد.
  • راه حل: در منوی دربان وارد «اعلان‌های پیامکی سفارش» شوید، قانون را کامل کنید و «ارسال آزمایشی با آخرین سفارش» را بزنید. آزمایش فقط به نخستین مدیر می‌رود. پس از موفقیت، وضعیت یک سفارش آزمایشی را واقعاً تغییر دهید تا اجرای قانون همان وضعیت نیز سنجیده شود.

۱۲) کاربر Digits به‌عنوان کاربر جدید شناخته می‌شود

  • نشانه: کاربر قدیمی با همان شماره قبلی وارد مسیر ساخت حساب می‌شود یا در گزارش انتقال رد شده است.
  • چه بررسی شود: در «همگام‌سازی Digits» نتیجه همان کاربر را بخوانید. شماره ممکن است قابل خواندن نباشد، اطلاعات کافی نداشته باشد یا حساب از قبل شماره متفاوتی در دربان داشته باشد. کد کشور پیش‌فرض نیز باید درست باشد.
  • راه حل: کد کشور و شماره حساب را اصلاح کنید و ابزار را دوباره اجرا کنید. اگر شماره متفاوتی از قبل در دربان وجود دارد، پس از تأیید مالکیت، مدیر باید شماره درست را دستی تعیین کند؛ ابزار آن را خودکار جایگزین نمی‌کند.

۱۳) فرم، پاپ‌آپ یا تغییر تنظیمات قدیمی مانده است

  • نشانه: صفحه برای مدیر درست است اما برای مهمان نسخه قدیمی دیده می‌شود، پاپ‌آپ باز نمی‌شود یا درخواست کد پس از بهینه‌سازی شکست می‌خورد.
  • چه بررسی شود: کش تمام‌صفحه، CDN، ترکیب یا تأخیر فایل‌های جاوااسکریپت و کش مرورگر را بررسی کنید. برگه ورود، حساب کاربری و تسویه‌حساب نباید نسخه ثابت مشترک میان کاربران دریافت کنند.
  • راه حل: این برگه‌ها را از کش تمام‌صفحه و تأخیر اسکریپت مستثنی کنید، همه لایه‌های کش را پاک کنید و در پنجره خصوصی آزمایش بگیرید. اگر مشکل باقی ماند، بهینه‌ساز را موقتاً خاموش کنید و سپس قابلیت‌هایش را یکی‌یکی برگردانید تا عامل تعارض مشخص شود.

۱۴) استفاده درست از گزارش اشکال‌زدایی

  • نشانه: آزمایش‌ها فقط خطای عمومی نشان می‌دهند یا مشکل با مراحل بالا قابل تکرار است اما علت روشن نیست.
  • چه بررسی شود: زمان دقیق رخداد، شماره به‌صورت پوشیده، نوع فرم، کانال و عملی که کاربر انجام داده است را یادداشت کنید. گزارش دربان اطلاعاتی مانند کدها، شماره کامل و کلیدهای محرمانه را ثبت نمی‌کند.
  • راه حل: در منوی دربان وارد «عیب‌یابی» شوید، «فعال‌سازی ثبت گزارش» را روشن کنید، مشکل را فقط یک‌بار بازسازی کنید و متن گزارش را بردارید. سپس ثبت گزارش را خاموش و محتوای آن را پاک کنید. برای صفحه سفید یا خطای شدید، گزارش خطای هاست را نیز در همان بازه زمانی بررسی کنید.
هنگام ارسال برای پشتیبانی رمز پنل پیامک، کلیدهای سرویس، لایسنس و اطلاعات کامل مشتری را نفرستید. نسخه دربان، نسخه PHP، متن خطا، نتیجه سلامت سامانه و مراحل دقیق بازسازی مشکل کافی است.