에러 처리는 비동기 스타일에 따라 다르며, 잘못하면 조용한 실패나 충돌을 일으킵니다. 핵심 원칙: async/await에는 try/catch를 사용하고, Promise rejection은 항상 처리하며, 비동기 콜백의 에러가 처리되지 않은 채 빠져나가지 않게 하는 것입니다.
() {
{
user = db.(id);
user;
} (err) {
logger.(err);
(, { : err });
}
}
fetchData()
.then(process)
.catch(err => logger.error(err)); // an unhandled rejection can crash the process
.catch(또는 await 주변의 try/catch)가 없는 Promise rejection은 unhandled rejection이 되며, 최신 Node에서는 프로세스를 종료시킵니다.
// ❌ 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는 현재 동기 호출 스택의 에러만 잡습니다. 타이머/콜백이 실행될 때쯤이면 try 블록은 이미 사라진 지 오래입니다. 에러는 콜백 내부에서 처리하세요.
// ❌ 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
}));
process.on("unhandledRejection", (reason) => { logger.error(reason); });
process.on("uncaughtException", (err) => { logger.error(err); process.exit(1); });
이들은 로그를 남기고 (잡히지 않은 예외의 경우) 깔끔하게 종료하기 위한 안전망이며, 에러가 발생하는 곳에서 처리하는 것을 대체하지 않습니다.
처리되지 않은 비동기 에러는 Node 서비스가 충돌하거나 조용히 망가지는 주요 원인입니다.
원칙을 숙달하는 것(await 주변의 try/catch, Promise는 항상 .catch, 비동기 콜백 내부에서 에러 처리(try/catch가 도달할 수 없음), Express 비동기 핸들러를 래핑하여 에러 전달)은 멈춘 요청, 조용한 실패, 프로세스 충돌을 방지합니다.
전역 핸들러는 최후의 안전망을 제공하지만, 작업별 올바른 처리야말로 비동기 Node 코드를 견고하고 디버깅 가능하게 만드는 것입니다.