اختبار الاستعلامات لعزل المشكلات

عندما يواجه تطبيق Node.js الذي يستخدم Mongoose سلوكاً غير متوقع — مثل نجاح بعض الاستعلامات بينما يتوقف البعض الآخر أو يفشل — فإن الاستراتيجية الأكثر فعالية هي العزل المنهجي. هذه العملية تساعدك على تحديد ما إذا كان أصل المشكلة من منطق الاستعلام، أو من تعريفات الـ Schema، أو من خادم MongoDB نفسه. في الأنظمة الإنتاجية الحقيقية، يمكن لهذا الأسلوب المنظم في تتبع الأخطاء أن يوفر ساعات من الإحباط ويمنع توقفات حرجة في الخدمة.

1. فهم المبدأ الأساسي: العزل

المفتاح لحل مشكلات الاستعلامات المتقطعة هو عزل كل طبقة محتملة — منطق التطبيق، Mongoose، و MongoDB — واختبارها بشكل مستقل. في العديد من السيناريوهات التجارية، خصوصاً في المتاجر الإلكترونية أو أنظمة التحليلات أو المنصات التعليمية، تصبح الاستعلامات أكثر تعقيداً مع مرور الوقت. تصفية مجموعات كبيرة، أو ربط المراجع، أو استخدام فلاتر ديناميكية قد يؤدي إلى فشل الاستعلامات أو انتهاء مهلة التنفيذ إذا لم تُختبر بالشكل الصحيح.

نصيحة: ابدأ دائماً بأبسط بيئة ممكنة. استعلام مباشر على قاعدة البيانات يكشف أكثر مما تكشفه مئات الأسطر من سجلات التطبيق.

2. سير عمل العزل خطوة بخطوة

الخطوة 1: تشغيل الاستعلام مباشرة في Mongo Shell

انسخ نفس الاستعلام الذي يفشل في تطبيقك وشغّله مباشرة في Mongo shell أو في واجهة مثل MongoDB Compass. هذه الخطوة تجيب على أهم سؤال: هل المشكلة في MongoDB أم في Mongoose؟


// Example Mongoose query:
await Profile.findOne({ email: "test@example.com" });

// Equivalent Mongo shell query:
db.profiles.findOne({ email: "test@example.com" });

إذا نجح الاستعلام في الـ Mongo shell لكنه فشل داخل تطبيق Node.js، فالمشكلة على الأغلب في طبقة Mongoose — مثل عدم تطابق الـ Schema، أو مشاكل في اتصال الـ Pool، أو منطق Middleware.

الخطوة 2: تسجيل الاستعلامات داخل Mongoose

فعِّل وضع التصحيح Debug في Mongoose لعرض كل استعلام يتم تنفيذه. هذا يساعدك على التأكد من أن التطبيق يرسل الاستعلامات كما تتوقع.


mongoose.set('debug', true);

بعد التفعيل، سيعرض الـ Console تفاصيل الاستعلامات، المعاملات، والتوقيت — مما يساعدك على اكتشاف الفلاتر غير الصحيحة أو التحويلات غير المتوقعة للبيانات.

الخطوة 3: استخدام `.explain()` للحصول على رؤى الأداء

عندما تكون الاستعلامات بطيئة أو تنتهي بمهلة، استخدم .explain("executionStats") لفحص خطة التنفيذ ومعرفة ما إذا كان MongoDB يستخدم فهارس أم يقوم بمسح كامل للمجموعة.


db.profiles.find({ active: true }).explain("executionStats");

تحقق مما إذا كانت قاعدة البيانات تقوم بـ COLLSCAN (مسح كامل) أو INDEXSCAN. إذا كانت تمسح المجموعة بالكامل، فإضافة فهرس على الحقول المستخدمة في الاستعلام (مثل email أو active) سيحسن الأداء بشكل كبير.

الخطوة 4: فحص الـ Schema وتعريفات النماذج

يمكن أن تتسبب تعريفات الـ Schema في Mongoose في مشاكل غير مرئية. على سبيل المثال: تعريف حقل على أنه Number أثناء تخزينه فعلياً كـ String قد يؤدي إلى عدم تطابق يمنع الاستعلام من إرجاع نتائج.

لمراجعة ذلك، قارن الـ Schema مع البيانات الفعلية المخزنة:


const ProfileSchema = new mongoose.Schema({
  email: String,
  age: Number,
  active: Boolean
});

إذا كانت البيانات المخزنة غير متوافقة أو تحتوي على أنواع مختلفة، ففكر في إضافة تحويلات Type Casting أو تنفيذ تحديثات Migration.

3. سيناريوهات شائعة من العالم الحقيقي

المتاجر الإلكترونية: المنتجات لا تظهر في البحث بسبب استخدام معرف نصي بدلاً من ObjectId.
لوحات التحليل: بطء كبير في إنشاء التقارير اليومية بسبب غياب الفهارس على تواريخ العمليات.
المنصات التعليمية: فشل تحديث بيانات تقدم الطلاب بسبب أخطاء في التحقق من صحة الـ Schema.

4. قائمة التحقق العملية

✅ تأكد من تشغيل خدمة MongoDB (sudo systemctl status mongod).
✅ اختبر الاستعلامات في Mongo shell.
✅ فعّل تسجيل الاستعلامات في Mongoose.
✅ استخدم .explain() لتحليل الأداء.
✅ تحقق من مطابقة الحقول والأنواع بين Schema والبيانات.
✅ أضف الفهارس المناسبة للحقول الأكثر استخداماً في الاستعلامات.

5. الخلاصة

فن تتبع أخطاء الاستعلامات يعتمد على الإقصاء المنطقي. من خلال عزل البيئة خطوة بخطوة — بدءاً من MongoDB، ثم Mongoose، ثم منطق التطبيق — يمكنك تحديد المشكلة بدقة واستعادة استقرار النظام بسرعة.

في عالم الأعمال الحديثة حيث تعتمد المنصات على البيانات وتجربة المستخدم، فإن إتقان هذا الأسلوب في تتبع الأخطاء يضمن أن تبقى تطبيقاتك مستقرة، فعّالة، وقابلة للتوسع. سواء كنت تدير منصة SaaS، نظام محتوى، أو متجر إلكتروني، فهذه المهارات عملية ويستخدمها ملايين المطورين يومياً.