Node.js에서 async/await 사용 시 발생하는 흔한 실수와 에러 핸들링 패턴

// 이전 작업이 끝날 때까지 무의미하게 기다림
async function getUserDashboard(userId: string) {
  const profile = await db.getProfile(userId); // 1초 소요
  const posts = await db.getPosts(userId);     // 1초 소요
  const alerts = await db.getAlerts(userId);   // 1초 소요
  
  return { profile, posts, alerts }; // 총 3초 소요!
}

// 병렬 처리로 시간 단축
async function getUserDashboard(userId: string) {
  // 세 작업을 동시에 실행시키고 한 번에 기다림
  const [profile, posts, alerts] = await Promise.all([
    db.getProfile(userId),
    db.getPosts(userId),
    db.getAlerts(userId)
  ]);
  
  return { profile, posts, alerts }; // 총 1초 소요!
}

// 루프가 끝나기 전에 함수가 종료됨
async function processUsers(users: User[]) {
  users.forEach(async (user) => {
    await db.updateStatus(user.id); // forEach는 이 await를 기다려주지 않습니다!
  });
  console.log("모든 유저 업데이트 완료?"); // 실제로는 업데이트가 끝나기 전에 출력됨
}

// 해결책 A (순차 처리 필요 시): 일반 for...of 문 사용
for (const user of users) {
  await db.updateStatus(user.id);
}

// 해결책 B (병렬 처리 가능 시): map + Promise.all 사용
await Promise.all(users.map(user => db.updateStatus(user.id)));

// await 누락
async function saveLog(message: string) {
  db.insertLog(message);
}

async function getProductDetail(productId: string) {
  try {
    const product = await productRepository.findById(productId);
    if (!product) {
      throw new CustomError('상품을 찾을 수 없습니다.', 404);
    }
    return product;
  } catch (error) {
    // 비동기 에러 및 커스텀 에러가 모두 여기로 집결
    logger.error(`상품 조회 실패: ${error.message}`);
    throw error; // 글로벌 에러 핸들러로 위임
  }
}

// 비동기 에러를 catch하여 next()로 던져주는 안전한 래퍼 함수
const asyncHandler = (fn: Function) => (req: Request, res: Response, next: NextFunction) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

// 컨트롤러에서는 try-catch 없이 깔끔하게 작성
app.get('/user/:id', asyncHandler(async (req, res) => {
  const user = await userService.find(req.params.id); // 여기서 터진 에러는 자동으로 next로 이동!
  res.json(user);
}));

// 공통 유틸리티 함수 정의
async function catchToTuple<T>(promise: Promise<T>): Promise<[Error | null, T | null]> {
  try {
    const data = await promise;
    return [null, data];
  } catch (error) {
    return [error as Error, null];
  }
}

// 비즈니스 로직에서의 활용
async function checkout(cartId: string) {
  const [error, cart] = await catchToTuple(db.getCart(cartId));
  
  if (error) {
    return { success: false, reason: "장바구니 조회 실패" };
  }
  // 이후 안전하게 cart 객체 활용 가능 (타입 가드 동작)
}