STUDY NOTE · 개념 정리
Spring MVC 요청 흐름 정리: DispatcherServlet, HandlerMapping, HandlerAdapter, ViewResolver
Backend
Spring MVC는 모든 요청을 DispatcherServlet 하나가 먼저 받는 프론트 컨트롤러 구조다. DispatcherServlet은 HandlerMapping으로 처리할 컨트롤러를 찾고, HandlerAdapter로 실행한 뒤, 결과가 뷰 이름이면 ViewResolver로 뷰를 찾아 렌더링하고, @ResponseBody면 HttpMessageConverter로 바로 JSON을 쓴다. 필터는 그 바깥(서블릿 컨테이너)에서, 인터셉터는 그 안(스프링)에서 동작한다.1. 전체 흐름
클라이언트
→ 서블릿 컨테이너 (톰캣)
→ Filter 체인 (서블릿 영역)
→ DispatcherServlet (여기부터 스프링 MVC)
1. HandlerMapping : 어떤 컨트롤러 메서드가 처리할지 찾음
2. HandlerAdapter : 그 핸들러를 실행할 수 있는 어댑터 선택
3. Interceptor.preHandle
4. ArgumentResolver : @RequestParam, @RequestBody 등 파라미터 준비
5. Controller 메서드 실행
6. ReturnValueHandler : 반환값 처리
├─ @ResponseBody → HttpMessageConverter가 응답 본문에 JSON 작성
└─ 뷰 이름 → (7) ViewResolver → View 렌더링 (JSP 등)
8. Interceptor.postHandle : 뷰 렌더링 전
9. Interceptor.afterCompletion : 응답 완료 후 (예외가 나도 호출)
2. 구성 요소별 역할
| 구성 요소 | 역할 | 대표 구현 |
| DispatcherServlet | 모든 요청의 진입점, 전체 흐름 조율 (프론트 컨트롤러) | - |
| HandlerMapping | URL·메서드·헤더 조건으로 핸들러와 인터셉터 목록(HandlerExecutionChain)을 찾음 | RequestMappingHandlerMapping (@RequestMapping) |
| HandlerAdapter | 핸들러 종류에 상관없이 같은 방식으로 실행하게 해 주는 어댑터 | RequestMappingHandlerAdapter |
| HandlerMethodArgumentResolver | 요청에서 컨트롤러 파라미터 값을 만들어 줌 | @RequestParam, @PathVariable, @ModelAttribute, @RequestBody 처리기 |
| HttpMessageConverter | HTTP 본문 ↔ 객체 변환 | JSON은 Jackson 기반 컨버터 |
| ViewResolver | 뷰 이름을 실제 View 객체로 변환 | InternalResourceViewResolver (JSP) |
| HandlerExceptionResolver | 처리 중 발생한 예외를 응답으로 변환 | @ExceptionHandler 처리기 등 |
HandlerAdapter가 따로 있는 이유는 핸들러 형태가 하나가 아니기 때문이다. 애너테이션 컨트롤러, 예전 Controller 인터페이스 구현체, HttpRequestHandler 등 서로 다른 핸들러를 DispatcherServlet이 직접 알 필요 없이 어댑터에 맡긴다(어댑터 패턴).
3. @Controller + 뷰 vs @RestController
| 구분 | @Controller (뷰 반환) | @RestController |
| 구성 | @Controller | @Controller + @ResponseBody |
| 반환값 의미 | 뷰 이름 (예: "order/list") | 응답 본문으로 쓸 객체 |
| 처리 | ViewResolver → JSP/Thymeleaf 렌더링 | HttpMessageConverter → JSON |
| 모델 전달 | Model에 값을 담아 뷰에서 사용 | 반환 객체가 곧 응답 |
# JSP 뷰 설정 (application.properties)
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
// 컨트롤러가 "order/list"를 반환하면
// → /WEB-INF/views/order/list.jsp 로 포워드되어 렌더링
4. 필터 vs 인터셉터
| 구분 | Filter | HandlerInterceptor |
| 소속 | 서블릿 스펙 (서블릿 컨테이너가 관리) | 스프링 MVC (스프링 컨텍스트가 관리) |
| 실행 위치 | DispatcherServlet 앞 | DispatcherServlet과 컨트롤러 사이 |
| 대상 | 모든 요청 (정적 리소스 포함 가능) | 핸들러로 매핑된 요청 |
| 핸들러 정보 | 모름 | 어떤 컨트롤러 메서드인지 앎 (애너테이션 확인 가능) |
| 요청·응답 객체 교체 | 가능 (래퍼로 감싸 넘기기) | 불가 |
| 예외 처리 | @ControllerAdvice로 잡을 수 없음 | @ControllerAdvice로 처리 가능 |
| 주 용도 | 인코딩, 보안(스프링 시큐리티), 요청 로깅, CORS | 로그인 확인, 권한 체크, 공통 모델 데이터 |
비즈니스 메서드 단위로 공통 로직이 필요하면 AOP를 쓴다. 정리하면 바깥에서부터 필터 → 인터셉터 → AOP 순으로 범위가 좁아진다.
public class LoginCheckInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
Object handler) throws Exception {
HttpSession session = request.getSession(false);
if (session == null || session.getAttribute("loginUser") == null) {
response.sendRedirect("/login");
return false; // false면 컨트롤러를 호출하지 않는다
}
return true;
}
}
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new LoginCheckInterceptor())
.addPathPatterns("/mypage/**")
.excludePathPatterns("/login", "/css/**", "/js/**");
}
}
5. 인터셉터 메서드의 호출 시점
| 메서드 | 호출 시점 | 주의 |
| preHandle | 컨트롤러 실행 전 | false 반환 시 이후 흐름 중단 |
| postHandle | 컨트롤러 실행 후, 뷰 렌더링 전 | 컨트롤러에서 예외가 나면 호출되지 않음. @ResponseBody는 이미 본문이 쓰여 응답 수정이 의미 없음 |
| afterCompletion | 뷰 렌더링까지 끝난 뒤 | 예외가 나도 호출됨 (예외 객체를 인자로 받음). 리소스 정리, 실행 시간 로그 |
6. 예외가 나면
컨트롤러에서 예외가 나면 DispatcherServlet이 등록된 HandlerExceptionResolver들에 차례로 처리를 맡긴다. @ExceptionHandler(컨트롤러 안 또는 @ControllerAdvice)가 있으면 그 메서드가 응답을 만들고, 아무도 처리하지 못하면 서블릿 컨테이너까지 올라가 기본 에러 페이지(스프링 부트는 /error)로 간다. 필터에서 난 예외는 DispatcherServlet 밖이라 @ControllerAdvice가 잡지 못한다.
7. 실제로 어떻게 적용되나
- JSP 기반 레거시와 API의 공존: 같은 애플리케이션 안에서 화면 컨트롤러는 뷰 이름을,
/api/**컨트롤러는@ResponseBody로 JSON을 반환한다. 둘 다 같은 DispatcherServlet을 거치고 반환값 처리 단계에서만 갈린다. - 권한 체크 위치 선택: "어떤 컨트롤러 메서드에 어떤 권한이 필요한가"를 애너테이션으로 표시하고 확인하려면 핸들러 정보를 아는 인터셉터(또는 AOP)가 맞다. 필터는 핸들러를 모른다.
- 요청 본문을 로그로 남기기: 요청 본문 스트림은 한 번만 읽을 수 있어서 인터셉터에서 읽으면 컨트롤러의
@RequestBody가 비게 된다. 필터에서ContentCachingRequestWrapper로 감싸 넘겨야 한다(요청 객체 교체는 필터만 가능). - 404인데 컨트롤러가 있는 경우: HandlerMapping이 핸들러를 못 찾은 것이다. 컨텍스트 경로, 클래스와 메서드의 매핑 경로 조합, HTTP 메서드, 컴포넌트 스캔 범위를 확인한다.
8. 면접 질문으로 정리
- Q. Spring MVC의 요청 처리 흐름은? DispatcherServlet이 요청을 받아 HandlerMapping으로 핸들러를 찾고, HandlerAdapter로 컨트롤러를 실행한다. 반환값이 뷰 이름이면 ViewResolver로 뷰를 찾아 렌더링하고, @ResponseBody면 HttpMessageConverter가 본문에 직접 쓴다.
- Q. DispatcherServlet이란? 모든 요청을 받는 프론트 컨트롤러로, 공통 처리를 한 곳에서 하고 실제 처리는 적절한 컨트롤러에 위임한다.
- Q. 필터와 인터셉터의 차이는? 필터는 서블릿 컨테이너가 관리하며 DispatcherServlet 앞에서 동작하고, 인터셉터는 스프링이 관리하며 DispatcherServlet과 컨트롤러 사이에서 동작해 핸들러 정보를 알 수 있다.
- Q. HandlerAdapter가 필요한 이유는? 핸들러의 형태가 다양해도 DispatcherServlet이 같은 방식으로 실행할 수 있도록 실행 방법을 감싸 주기 때문이다.
- Q. @Controller와 @RestController의 차이는? @Controller는 기본적으로 뷰 이름을 반환하고, @RestController는 @ResponseBody가 포함돼 반환 객체를 HttpMessageConverter로 응답 본문에 쓴다.