سوء معالجة الحالات الاستثنائية Mishandling of Exceptional Conditions

الصياغة

معالج أخطاء مركزي + رسالة عامة للمستخدم + تفاصيل كاملة في السجلات فقط + Fail Closed دائمًا

📄 مثال

// سيئ
app.get('/api/x', async (req, res) => {
  const x = await db.x.findUniqueOrThrow({ where: { id: req.params.id } });
  res.json(x);
}); // استثناء غير ملتقَط = 500 مع stack trace كامل للمستخدم

// جيد
app.get('/api/x', async (req, res) => {
  try {
    const x = await db.x.findUniqueOrThrow({ where: { id: req.params.id } });
    res.json(x);
  } catch (err) {
    logger.error({ err, requestId: req.id });
    res.status(404).json({ error: 'غير موجود', requestId: req.id });
  }
});

أهم النقاط

💡 نصائح عملية

• اختبر مسارات الفشل بنفس جدّية مسارات النجاح — أغلب هذه الثغرات تظهر فقط تحت ظروف استثنائية لم تُختبَر

⚠️ أخطاء شائعة

• إرجاع err.message أو err.stack مباشرة في استجابة API بدل رسالة عامة

خصائص ذات صلة