كيف تتعامل مع الأخطاء في كود async في Node؟

Question

Accepted Answer

يختلف معالجة الأخطاء حسب أسلوب async، وعدم التعامل الصحيح معها يسبب فشلًا صامتًا أو أعطالًا. القواعد الرئيسية: استخدم `try/catch` مع async/await، تعامل دائمًا مع Promise rejections، ولا تدع الأخطاء في async callbacks تهرب بدون معالجة.

## async/await — استخدم try/catch

```js
async function getUser(id) {
  try {
    const user = await db.findUser(id);   // a rejection here throws into catch
    return user;
  } catch (err) {
    logger.error(err);
    throw new AppError("Failed to load user", { cause: err }); // rethrow meaningfully
  }
}
```

## Promises — استخدم دائمًا .catch

```js
fetchData()
  .then(process)
  .catch(err => logger.error(err)); // an unhandled rejection can crash the process
```

رفض Promise بدون `.catch` (أو بدون try/catch حول `await`) يصبح **رفضًا غير معالج** — وهذا في Node الحديث يوقف العملية.

## الفخ الكلاسيكي: الأخطاء في async callbacks تهرب من try/catch

```js
// ❌ try/catch does NOT catch this — the throw happens on a LATER tick
try {
  setTimeout(() => { throw new Error("boom"); }, 100);
} catch (e) { /* never runs */ }
```

`try/catch` يمسك فقط الأخطاء في **حالة** call stack المتزامنة الحالية. بعد وقت طويل من تشغيل المؤقت/callback، كتلة `try` اختفت. تعامل مع الخطأ *داخل* callback.

## معالجات مسارات Express async تحتاج إلى تغليف

```js
// ❌ a rejected async handler isn't caught by Express → request hangs
app.get("/users", async (req, res) => {
  const users = await db.getUsers(); // if this throws, Express doesn't catch it (pre-v5)
  res.json(users);
});

// ✅ wrap to forward errors to Express's error handler
const asyncH = (fn) => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
app.get("/users", asyncH(async (req, res) => {
  res.json(await db.getUsers()); // errors now go to next() → error middleware
}));
```

## شبكات الأمان العالمية (الملاذ الأخير، وليس المعالجة الأساسية)

```js
process.on("unhandledRejection", (reason) => { logger.error(reason); });
process.on("uncaughtException", (err) => { logger.error(err); process.exit(1); });
```

هذه شبكات أمان لتسجيل الأخطاء و(للاستثناءات غير المعالجة) الخروج بنظافة — وليست بديلًا عن معالجة الأخطاء حيث تحدث.

## لماذا يهم

أخطاء async غير المعالجة هي من أكثر الأسباب لتعطل خدمات Node أو فشلها الصامت.

إتقان القواعد — `try/catch` حول `await`، دائمًا `.catch` للـ Promises، معالجة الأخطاء *داخل* async callbacks (لا يستطيع try/catch الوصول إليها)، وتغليف معالجات مسارات Express لإعادة توجيه الأخطاء — يمنع الطلبات المعلقة والفشل الصامت وأعطال العملية.

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