استكشاف أخطاء اتصال قاعدة البيانات المحلية وإصلاحها في Node.js وMongoDB

إذا سبق لك تطوير تطبيق Node.js يتصل بـ MongoDB باستخدام Mongoose، فربما واجهت هذه الرسالة المزعجة:

MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017

هذا الخطأ يعني أن تطبيقك حاول الاتصال بـ MongoDB، لكن خادم قاعدة البيانات لم يستجب. لا تقلق — فهذا يحدث يوميًا لملايين المطورين حول العالم، وغالبًا ما يتم إصلاحه في بضع خطوات بسيطة.

1. فهم السبب الجذري للمشكلة

يشير الخطأ ECONNREFUSED إلى أن جهازك أو الخادم رفض طلب الاتصال بـ MongoDB. يحدث هذا عادةً بسبب:

• عدم تشغيل MongoDB محليًا.
• المنفذ 27017 مستخدم أو محجوب.
• وجود خطأ في سلسلة الاتصال (Connection String).
• وجود جدار حماية أو مشكلة صلاحيات تمنع الاتصال.

قبل البدء في خطوات معقدة، ابدأ بالتأكد من أن MongoDB يعمل ويستقبل الاتصالات.

2. التحقق من أن MongoDB يعمل

استخدم هذا الأمر للتحقق مما إذا كان MongoDB نشطًا:

sudo service mongod status

إذا لم يكن يعمل، شغّله باستخدام:

sudo service mongod start

أو إذا كنت تشغّله يدويًا في بيئة التطوير:

mongod

بعد تشغيله، يجب أن ترى سجلات تؤكد أنه يستمع على المنفذ 27017.

3. التأكد من صحة مسار الاتصال (Connection URI)

من أكثر الأسباب شيوعًا هو وجود خطأ بسيط في سلسلة الاتصال الخاصة بـ Mongoose. يجب أن يبدو الكود بهذا الشكل:

mongoose.connect('mongodb://localhost:27017/mydatabase', {
  useNewUrlParser: true,
  useUnifiedTopology: true
});

تأكد من:

• أن اسم قاعدة البيانات (مثل mydatabase) صحيح.
• أنك تستخدم localhost وليس اسم مضيف غير قابل للوصول.
• إذا كنت تستخدم MongoDB عبر Docker أو Atlas، فاحرص على مطابقة الإعدادات.

4. التحقق من تعارض المنافذ أو الجدار الناري

المنفذ 27017 هو المنفذ الافتراضي لـ MongoDB. إذا كان هناك تطبيق آخر يستخدمه، فلن يتمكن MongoDB من العمل. تحقق مما يعمل على هذا المنفذ:

sudo lsof -i :27017

إذا وجدت عملية أخرى تستخدمه، يمكنك إيقافها أو تغيير إعدادات MongoDB في ملف mongod.conf.

5. إضافة سجلات (Logging) لمحاولات الاتصال

المطورون المحترفون يسجلون كل شيء — فهذا يسهل اكتشاف مكان المشكلة بالضبط. أضف تسجيلًا كالتالي:

mongoose.connect('mongodb://localhost:27017/mydatabase', {
  useNewUrlParser: true,
  useUnifiedTopology: true
})
.then(() => console.log('✅ تم الاتصال بـ MongoDB بنجاح'))
.catch(err => console.error('❌ خطأ في اتصال MongoDB:', err));

هذا السجل البسيط قد يوفر عليك ساعات من البحث، خصوصًا أثناء تشغيل التطبيق محليًا أو في بيئة الإنتاج.

6. مثال عملي من الحياة الواقعية

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

هذا المثال يوضح أن فهم مشاكل الاتصال ليس مجرد جانب تقني — بل هو جزء أساسي للحفاظ على الأعمال متصلة وعملاءك راضين.

7. أخطاء شائعة ونصائح لتجنبها

• تأكد من تشغيل MongoDB تلقائيًا عند إقلاع النظام (systemctl enable mongod).
• اجعل منطق اتصال Mongoose منفصلًا وقابلًا لإعادة الاستخدام.
• استخدم المتغيرات البيئية لتخزين بيانات الاتصال بدلاً من كتابتها داخل الكود.
• راقب السجلات باستمرار باستخدام أدوات مثل pm2 أو winston.

8. الخلاصة

قد تبدو أخطاء الاتصال مثل ECONNREFUSED مخيفة، لكنها من أسهل المشكلات التي يمكن حلها عند فهم السبب. ابدأ دائمًا بالتحقق من خدمة MongoDB، ثم تحقق من سلسلة الاتصال والجدار الناري والسجلات.

تعلم أسلوب منهجي في تتبع الأخطاء يجعلك قادرًا على حل هذا النوع من المشاكل — وتطبيق نفس المهارات على جميع التحديات المستقبلية في الباك إند.