Day 27 · 5/5
🌿 중급 백엔드

미들웨어(Middleware)란?

쉽게 이해하기

공항 보안 검색대를 생각해보세요. 탑승구에 가기 전에 반드시 보안 검색을 거쳐야 하죠. 통과하면 다음 단계로 가고, 문제가 있으면 막히잖아요. 미들웨어도 마찬가지로 본격적인 API 처리 전에 '이 요청이 적절한가?' 검사하는 중간 관문이에요.

핵심 정리

요청이 서버에 도착하면 본격적인 처리 전에 먼저 거치는 중간 단계예요.

자세히 알아보기

미들웨어(Middleware)는 클라이언트 요청이 서버에 도착했을 때, 실제 비즈니스 로직을 실행하기 전에 거치는 중간 처리 단계입니다. 로그인 확인, 로그 기록, 데이터 변환 같은 공통 작업을 미들웨어에서 처리해요. 예를 들어 인증 미들웨어는 모든 API 요청에서 토큰을 검사합니다. 토큰이 유효하면 다음 단계로 진행하고, 없거나 만료됐으면 401 에러를 반환하는 거죠. 이렇게 하면 각 API마다 일일이 인증 코드를 쓰지 않아도 돼요. Node.js의 Express 프레임워크에서는 'app.use(middleware)'로 미들웨어를 등록해요. 요청이 들어오면 등록된 순서대로 미들웨어를 거치게 됩니다. 로그 미들웨어 → 인증 미들웨어 → CORS 미들웨어 → 실제 API 핸들러 순으로 실행되는 식이죠. 실무에서는 에러 처리, 요청/응답 로깅, CORS 설정, 파일 업로드, JSON 파싱 등 다양한 용도로 미들웨어를 씁니다. 미들웨어 덕분에 코드 중복을 줄이고, 관심사를 분리할 수 있어요. API마다 반복되는 코드를 미들웨어로 빼면 유지보수가 훨씬 쉬워집니다.