Async Node kodunda hataları nasıl ele alırsınız?

Question

Accepted Answer

Hata yönetimi async stiline göre farklılık gösterir ve yanlış yapıldığında sessiz arızalara veya çökmelerine neden olur. Temel kurallar: `try/catch` ile async/await kullanın, her zaman Promise red tutmalarını ele alın ve async callback'lerde oluşan hataların işlenmeden kaçmasını önleyin.

## async/await — try/catch kullanın

```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 — her zaman .catch

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

`.catch` olmayan (veya `await` etrafında `try/catch` olmayan) bir Promise red tutması **işlenmemiş bir red tutma** olur — modern Node'da bu işlemi sonlandırır.

## Klasik tuzak: async callback'lerdeki hatalar try/catch'ten kaçar

```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` yalnızca **geçerli** senkron çağrı yığınındaki hataları yakalar. Timer/callback çalıştığında, `try` bloğu uzun süredir geçmişte kalmıştır. Hatayı *callback içinde* ele alın.

## Express async route handler'ları sarmalama gerektirir

```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
}));
```

## Global güvenlik ağları (son çare, birincil yönetim değil)

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

Bunlar günlüğe kaydetmek ve (yakalanmamış istisnalar için) temiz çıkmak için güvenlik ağlarıdır — hataları oluştukları yerde ele almanın yerine geçmez.

## Neden önemli

İşlenmemiş async hatalar, çökmüş veya sessiz bir şekilde bozulmuş Node hizmetlerinin en önemli nedenidir.

Kuralların üzerinde hakim olmak — `await` etrafında `try/catch`, her zaman `.catch` Promise'leri, hataları *async callback'leri içinde* ele almak (try/catch onlara ulaşamaz) ve hataları iletmek için Express async handler'larını sarmalamak — asılı istekleri, sessiz arızaları ve işlem çökmelerini önler.

Global handler'lar son bir güvenlik ağı sağlar, ancak doğru başına işlem yönetimi async Node kodunu sağlam ve hata ayıklanabilir yapar.