البحث في الأخطاء
أخطاء المصادقة والتسجيل
فشل تسجيل الدخول
عالي
الأسباب المحتملة:
- كلمة مرور خاطئة
- البريد الإلكتروني غير مسجل
- الحساب معطل أو محذوف
- مشكلة في قاعدة البيانات
الحلول:
- تأكد من صحة البريد الإلكتروني وكلمة المرور
- استخدم خاصية "نسيت كلمة المرور" لإعادة تعيينها
- تحقق من حالة الحساب في لوحة التحكم
- راجع سجلات النظام للأخطاء
// Laravel Log Check
tail -f storage/logs/laravel.log
خطأ في تنسيق البريد الإلكتروني
متوسط
رسالة الخطأ:
يجب أن يكون البريد الإلكتروني بريداً إلكترونياً صحيحاً
الحل:
- تأكد من وجود @ في البريد الإلكتروني
- تأكد من وجود نطاق صحيح (مثل .com, .org)
- تجنب المسافات والرموز الخاصة
مثال صحيح: user@example.com
تأكيد كلمة المرور غير متطابق
متوسط
رسالة الخطأ:
تأكيد كلمة المرور غير متطابق
الحل:
- تأكد من كتابة نفس كلمة المرور في الحقلين
- انتبه للأحرف الكبيرة والصغيرة
- تأكد من عدم وجود مسافات إضافية
أخطاء التحقق من البيانات
الحقل مطلوب
عالي
رسالة الخطأ:
هذا الحقل مطلوب
الحل:
- تأكد من ملء جميع الحقول المطلوبة
- ابحث عن الحقول المميزة بعلامة (*)
- تأكد من عدم ترك مسافات فارغة فقط
حجم الملف كبير جداً
متوسط
رسالة الخطأ:
يجب ألا يكون حجم الملف أكبر من 2048 كيلوبايت
الحل:
- ضغط الصورة قبل الرفع
- استخدام أدوات ضغط الصور المجانية
- تغيير تنسيق الصورة إلى JPEG
- تقليل دقة الصورة
ملاحظة: الحد الأقصى المسموح: 2 ميجابايت
القيمة مستخدمة بالفعل
متوسط
رسالة الخطأ:
البريد الإلكتروني مستخدم بالفعل
الحل:
- استخدم بريد إلكتروني مختلف
- تحقق من وجود حساب سابق
- استخدم خاصية استرداد الحساب
أخطاء قاعدة البيانات
فشل الاتصال بقاعدة البيانات
عالي
الأسباب المحتملة:
- إعدادات قاعدة البيانات خاطئة
- خادم قاعدة البيانات متوقف
- كلمة مرور قاعدة البيانات خاطئة
- منفذ الاتصال مغلق
الحل:
- تحقق من ملف .env
- تأكد من تشغيل خادم MySQL
- اختبر الاتصال يدوياً
- راجع إعدادات الجدار الناري
// Check .env file
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password
خطأ في Migration
متوسط
الحل:
- تشغيل migrate:fresh
- حذف الجداول يدوياً
- إعادة تشغيل المهاجرات
- تشغيل seeders
php artisan migrate:fresh --seed
أخطاء الدفع والطلبات
طريقة الدفع غير متاحة
عالي
رسالة الخطأ:
طريقة الدفع غير صحيحة أو غير متاحة
الحل:
- تحقق من تفعيل طريقة الدفع في الإعدادات
- راجع إعدادات بوابة الدفع
- تأكد من صحة API Keys
- اختبر الاتصال مع بوابة الدفع
كود الخصم غير صحيح
متوسط
الأسباب المحتملة:
- الكوبون منتهي الصلاحية
- تم استخدام الكوبون الحد الأقصى
- لا يطبق على المنتجات المختارة
- الحد الأدنى للطلب غير محقق
الحل:
- تحقق من تاريخ انتهاء الكوبون
- راجع شروط استخدام الكوبون
- تأكد من وصول قيمة الطلب للحد الأدنى
خدمة الشحن غير متاحة
متوسط
رسالة الخطأ:
خدمة الشحن غير متاحة حالياً
الحل:
- تحقق من تفعيل خدمة الشحن
- راجع مناطق الشحن المتاحة
- تأكد من وجود عنوان شحن صحيح
أخطاء المنتجات والمخزون
المنتج غير متوفر
عالي
الحل:
- تحديث كمية المخزون
- تفعيل خاصية "إشعار عند التوفر"
- إخفاء المنتج من الواجهة
- عرض منتجات بديلة
فشل رفع صورة المنتج
متوسط
الأسباب المحتملة:
- تنسيق الصورة غير مدعوم
- حجم الصورة كبير جداً
- مشكلة في صلاحيات المجلد
- مساحة التخزين ممتلئة
الحل:
- استخدم التنسيقات المدعومة: JPG, PNG, GIF
- ضغط الصورة قبل الرفع
- تحقق من صلاحيات مجلد storage
- تنظيف مساحة التخزين
// Fix storage permissions
chmod -R 755 storage/
chown -R www-data:www-data storage/
أخطاء النظام والأداء
خطأ خادم داخلي 500
عالي
الأسباب المحتملة:
- خطأ في الكود البرمجي
- مشكلة في صلاحيات الملفات
- نفاد الذاكرة
- خطأ في إعدادات الخادم
الحل:
- فحص سجلات الأخطاء
- تحقق من صلاحيات الملفات
- زيادة حد الذاكرة
- تحديث composer dependencies
// Check error logs
tail -f storage/logs/laravel.log
// Clear cache
php artisan cache:clear
php artisan config:clear
php artisan view:clear
تجاوز حد الذاكرة
عالي
رسالة الخطأ:
Fatal error: Allowed memory size exhausted
الحل:
- زيادة memory_limit في php.ini
- تحسين الاستعلامات
- استخدام pagination للبيانات الكبيرة
- تحسين الكود لاستهلاك ذاكرة أقل
// In php.ini
memory_limit = 512M
// Or in Laravel
ini_set('memory_limit', '512M');
انتهاء صلاحية الجلسة
متوسط
الحل:
- تسجيل الدخول مرة أخرى
- زيادة مدة الجلسة في الإعدادات
- تفعيل "تذكرني" عند تسجيل الدخول
// In config/session.php
'lifetime' => 120, // minutes
أخطاء البريد والرسائل
فشل إرسال البريد الإلكتروني
عالي
الأسباب المحتملة:
- إعدادات SMTP خاطئة
- البريد محظور كـ spam
- مشكلة في خادم البريد
- تجاوز حد الإرسال اليومي
الحل:
- تحقق من إعدادات SMTP في .env
- اختبر الاتصال بخادم البريد
- راجع قوائم spam
- استخدم خدمة بريد موثوقة
// Test email configuration
php artisan tinker
Mail::raw('Test email', function($msg) {
$msg->to('test@example.com')->subject('Test');
});
فشل إرسال الرسائل النصية
متوسط
الأسباب المحتملة:
- إعدادات Twilio خاطئة
- رقم الهاتف غير صحيح
- نفاد رصيد الرسائل
- رقم محظور
الحل:
- تحقق من Twilio credentials
- تأكد من صحة رقم الهاتف
- راجع رصيد الحساب
- فحص قائمة الأرقام المحظورة
أخطاء الأمان
خطأ في رمز الأمان CSRF
عالي
رسالة الخطأ:
CSRF token mismatch
الحل:
- تحديث الصفحة وإعادة المحاولة
- مسح cookies المتصفح
- تحقق من وجود @csrf في النماذج
- راجع إعدادات الجلسة
@csrf
headers: {
'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
}
وصول غير مصرح
عالي
الأسباب المحتملة:
- المستخدم غير مسجل دخول
- صلاحيات غير كافية
- انتهاء صلاحية الجلسة
- حساب معطل
الحل:
- تسجيل الدخول بحساب صحيح
- التحقق من الصلاحيات
- التواصل مع المدير