TypeScript Academy · 강의

오류 미들웨어와 결과 타입

중앙 오류 처리기와 타입이 지정된 Result 패턴을 설계하고, 비동기 처리기를 감싸 오류를 전달하며, 일관된 오류 봉투를 반환합니다.

오류 미들웨어와 결과 타입은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 3개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

소개

목표: 런타임 오류를 중앙에서 처리하고 일관된 JSON “오류 응답 형식”을 반환합니다. 결과 타입, 비동기 핸들러 래퍼, 견고한 오류 미들웨어를 만듭니다.

판별된 결과<T,E>
비동기 핸들러에서 next(err) 호출
알 수 없는 값→타입이 지정된 오류 매핑

결과 타입

함수 결과에는 판별 유니언을 사용하십시오: { ok: true; value } 또는 { ok: false; error }입니다. 호출자는 두 분기를 모두 처리해야 합니다.

// Result pattern for services and controllers
export type Ok<T> = { ok: true; value: T }
export type Err<E> = { ok: false; error: E }
export type Result<T, E = string> = Ok<T> | Err<E>

export const ok = <T>(value: T): Ok<T> => ({ ok: true, value })
export const err = <E>(error: E): Err<E> => ({ ok: false, error })

// Example usage
async function getUserName(id: string): Promise<Result<string, "NOT_FOUND" | "DB">> {
  if (id === "missing") return err("NOT_FOUND")
  try { return ok("Ada") } catch { return err("DB") }
}

오류 응답 형식

알 수 없는 값을 작고 예측 가능한 응답 형식으로 정규화하십시오. 클라이언트에 스택 추적 정보가 노출되지 않도록 하십시오.

// Canonical error envelope
export type ErrorEnvelope = {
  error: string
  code?: string
  details?: unknown
}

export function mapError(u: unknown): ErrorEnvelope {
  if (u instanceof Error) return { error: u.message }
  if (typeof u === "string") return { error: u }
  try { return { error: JSON.stringify(u) } } catch { return { error: "Unknown error" } }
}

비동기 래퍼 및 미들웨어

모든 비동기 핸들러를 래퍼로 감싸 거부가 발생하면 next(err)를 호출하도록 하십시오. 최종 오류 미들웨어가 JSON을 한 번만 형식화합니다.

import express, { Request, Response, NextFunction } from "express"

export const asyncHandler = <P, ResBody, ReqBody, Query>(fn: (req: Request<P, ResBody, ReqBody, Query>, res: Response<ResBody>, next: NextFunction) => Promise<unknown>) => {
  return (req: Request<P, ResBody, ReqBody, Query>, res: Response<ResBody>, next: NextFunction) => {
    Promise.resolve(fn(req, res, next)).catch(next)
  }
}

export function errorMiddleware(err: unknown, _req: Request, res: Response, _next: NextFunction) {
  const env = mapError(err)
  const status = env.code === "NOT_FOUND" ? 404 : 500
  res.status(status).json(env)
}

// Usage
// app.get("/", asyncHandler(async (req, res) => { throw new Error("boom") }))
// app.use(errorMiddleware)

라우트 및 통합

검증과 오류 처리를 결합하십시오. 검증에 실패하면 세부 정보와 함께 400을 반환하고, 그 밖의 거부는 중앙 미들웨어가 처리합니다.

import express from "express"
import { z } from "zod"
import { asyncHandler, errorMiddleware } from "./errors"

const createUserSchema = z.object({ name: z.string().min(1) })

const app = express()
app.use(express.json())

app.post("/users", asyncHandler(async (req, res) => {
  const parsed = createUserSchema.safeParse(req.body)
  if (!parsed.success) {
    res.status(400).json({ error: "Invalid body", details: parsed.error.format() })
    return
  }
  res.status(201).json({ id: "u_1", name: parsed.data.name })
}))

app.use(errorMiddleware)

app.listen(3000, () => console.log("http://localhost:3000"))

팁

팁:

서버 측 세부 정보는 기록하고 클라이언트에는 최소한의 메시지만 반환하십시오.
서비스에서는 타입이 지정된 결과를 우선 사용하고, 경계에서 HTTP로 매핑하십시오.
거부를 절대 무시하지 말고 항상 next(err)를 호출하십시오.

비동기 오류 확인

빠른 확인: 비동기 오류를 올바르게 전달하는 패턴은 무엇입니까?

요약

요약: 도메인 로직에는 결과 유니언을 사용하고, 비동기 핸들러를 감싸 next를 호출하게 하며, 최종 미들웨어에서 오류를 한 번만 형식화하십시오.

자주 묻는 질문

“오류 미들웨어와 결과 타입” 강의는 무료인가요?

네 — “오류 미들웨어와 결과 타입” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

“오류 미들웨어와 결과 타입”에서 뭘 배우나요?

중앙 오류 처리기와 타입이 지정된 Result 패턴을 설계하고, 비동기 처리기를 감싸 오류를 전달하며, 일관된 오류 봉투를 반환합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 3번째 강의입니다.

“오류 미들웨어와 결과 타입” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← TypeScript Academy(으)로 돌아가기