GM 오락실
← 개인 공부 · Backend
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모든 요청의 진입점, 전체 흐름 조율 (프론트 컨트롤러)-
HandlerMappingURL·메서드·헤더 조건으로 핸들러와 인터셉터 목록(HandlerExecutionChain)을 찾음RequestMappingHandlerMapping (@RequestMapping)
HandlerAdapter핸들러 종류에 상관없이 같은 방식으로 실행하게 해 주는 어댑터RequestMappingHandlerAdapter
HandlerMethodArgumentResolver요청에서 컨트롤러 파라미터 값을 만들어 줌@RequestParam, @PathVariable, @ModelAttribute, @RequestBody 처리기
HttpMessageConverterHTTP 본문 ↔ 객체 변환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 인터셉터

구분FilterHandlerInterceptor
소속서블릿 스펙 (서블릿 컨테이너가 관리)스프링 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. 실제로 어떻게 적용되나

  1. JSP 기반 레거시와 API의 공존: 같은 애플리케이션 안에서 화면 컨트롤러는 뷰 이름을, /api/** 컨트롤러는 @ResponseBody로 JSON을 반환한다. 둘 다 같은 DispatcherServlet을 거치고 반환값 처리 단계에서만 갈린다.
  2. 권한 체크 위치 선택: "어떤 컨트롤러 메서드에 어떤 권한이 필요한가"를 애너테이션으로 표시하고 확인하려면 핸들러 정보를 아는 인터셉터(또는 AOP)가 맞다. 필터는 핸들러를 모른다.
  3. 요청 본문을 로그로 남기기: 요청 본문 스트림은 한 번만 읽을 수 있어서 인터셉터에서 읽으면 컨트롤러의 @RequestBody가 비게 된다. 필터에서 ContentCachingRequestWrapper로 감싸 넘겨야 한다(요청 객체 교체는 필터만 가능).
  4. 404인데 컨트롤러가 있는 경우: HandlerMapping이 핸들러를 못 찾은 것이다. 컨텍스트 경로, 클래스와 메서드의 매핑 경로 조합, HTTP 메서드, 컴포넌트 스캔 범위를 확인한다.

8. 면접 질문으로 정리

  1. Q. Spring MVC의 요청 처리 흐름은? DispatcherServlet이 요청을 받아 HandlerMapping으로 핸들러를 찾고, HandlerAdapter로 컨트롤러를 실행한다. 반환값이 뷰 이름이면 ViewResolver로 뷰를 찾아 렌더링하고, @ResponseBody면 HttpMessageConverter가 본문에 직접 쓴다.
  2. Q. DispatcherServlet이란? 모든 요청을 받는 프론트 컨트롤러로, 공통 처리를 한 곳에서 하고 실제 처리는 적절한 컨트롤러에 위임한다.
  3. Q. 필터와 인터셉터의 차이는? 필터는 서블릿 컨테이너가 관리하며 DispatcherServlet 앞에서 동작하고, 인터셉터는 스프링이 관리하며 DispatcherServlet과 컨트롤러 사이에서 동작해 핸들러 정보를 알 수 있다.
  4. Q. HandlerAdapter가 필요한 이유는? 핸들러의 형태가 다양해도 DispatcherServlet이 같은 방식으로 실행할 수 있도록 실행 방법을 감싸 주기 때문이다.
  5. Q. @Controller와 @RestController의 차이는? @Controller는 기본적으로 뷰 이름을 반환하고, @RestController는 @ResponseBody가 포함돼 반환 객체를 HttpMessageConverter로 응답 본문에 쓴다.
Gunmo Lee
since 2021.07
Spring MVC 요청 흐름 정리: DispatcherServlet, HandlerMapping, HandlerAdapter, ViewResolver | GM 오락실