🛡️ 서블릿 필터 vs 스프링 인터셉터, 언제 어떤 걸 써야 할까?

조시와 쿤의 테코톡: 서블릿 필터 & 스프링 인터셉터 발표를 보고 정리한 내용입니다.
실무와 학습에서 필터와 인터셉터의 차이, 적절한 사용 시점에 대한 감을 잡는 데 도움이 됩니다.

---

🧩 공통 관심사의 분리

장바구니에 물품을 추가하는 addCart(), 장바구니의 물품을 조회하는 getCarts() 같은 기능은 로그인이 필수입니다.
→ 모든 메서드에 인증로직을 반복해야 하나요?

아니요!
이런 반복되는 부분을 **공통 관심사(Cross-cutting concern)**라고 하며, 이를 한 곳에 모아 처리하면 코드가 훨씬 깔끔해집니다.

---

🧪 필터(Filter)

💡 필터 등록 방법

1. @Component

• 전체 URL에 적용됨
• URL 패턴 지정 불가 ❌

2. @WebFilter + @ServletComponentScan

@WebFilter(urlPatterns = "/api/*")
public class MyFilter implements Filter { ... }

@SpringBootApplication
@ServletComponentScan
public class App {}

@ServletComponentScan: 웹 필터, 웹 서블릿, 웹 리스너 같이 서블릿 객체를 서블릿 컨테이너 위에 올리는 동작을 시켜주는 어노테이션

• 필터 URL 지정 가능
• 스프링 빈이 아닌 서블릿 컨테이너에 등록됨
• @Order 사용 불가 ❌

3. FilterRegistrationBean 사용 (권장)

@Bean
public FilterRegistrationBean<MyFilter> loggingFilter() {
    FilterRegistrationBean<MyFilter> registration = new FilterRegistrationBean<>();
    registration.setFilter(new MyFilter());
    registration.setOrder(1);
    registration.addUrlPatterns("/api/*");
    return registration;
}

• setFilter: 필터 등록
• setOrder: 순서 지정
• addUrlPatterns: URL 지정
• 유연하고 명시적 ✅

---

⚙️ 서블릿 필터 동작 방식

• 필터 체인은 ApplicationFilterChain으로 실행됨
• 내부적으로 doFilter() → internalDoFilter() 호출

• n: 총 등록된 필터의 개수. 필터들은 Array로 관리
• pos: 배열의 인덱스
• filterConfig: 필터 정보를 가지고 있는 filterConfig 배열

---

🌀 스프링 인터셉터(Interceptor)

✅ 역할

컨트롤러 실행 전/후에 동작하는 스프링 전용 컴포넌트
인증, 인가, 로깅, 예외 핸들링 등 활용 가능

---

⚙️ 제공 메서드

메서드	설명
preHandle	컨트롤러 실행 전 호출
postHandle	컨트롤러 실행 후, 뷰 렌더링 전
afterCompletion	뷰까지 렌더링 후 마지막 처리

모두 디폴트 메서드이므로 필요한 것만 오버라이드하면 됨

---

🔧 등록 방법

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyInterceptor())
                .addPathPatterns("/api/**")
                .excludePathPatterns("/auth/**");
    }
}

• addInterceptors: 인터셉터 추가, 등록된 순서대로 실행됨
• addPathPatterns: URI 규칙을 설정
• excludePathPatterns: 인터셉터를 적용시키지 않을 URI를 설정

---

🧭 인터셉터 동작 순서

[Filter] → DispatcherServlet
→ getHandler (핸들러 & 인터셉터 목록 확보)
→ preHandle 순차 실행
→ Controller 실행
→ postHandle 역순 실행
→ ViewResolver 호출
→ afterCompletion 역순 실행

인터셉터는 스프링 컨텍스트 안에서 컨트롤러를 기준으로 전후를 감쌈
기본적으로 스프링이 제공하는 핸들러 체인 안에서 실행됨

---

🔍 필터 vs 인터셉터 차이점 정리

항목	필터	인터셉터
기술 기반	자바 EE 서블릿 스펙	스프링 프레임워크
등록 대상	서블릿 컨테이너	스프링 빈
실행 위치	DispatcherServlet 이전	DispatcherServlet 이후
예외 처리	스프링 MVC 예외 처리 체인 외부 (예외 핸들러 동작 불가)	스프링 MVC 예외 처리 체인 내부 (잡아서 처리 가능)
request/response 교체	가능	불가
순서 지정	FilterRegistrationBean으로 가능	registry.order() 등으로 가능

---

🤔 언제 필터, 언제 인터셉터?

✅ 필터 추천 상황

• 로깅, 인코딩, CORS, HTTP Method override 등 웹 전반의 요청 처리
• 서블릿 기준 전처리
• 보안 관련 헤더 설정 등

✅ 인터셉터 추천 상황

• 인증/인가
• 로그인 여부 검증
• 요청 attribute 추가
• 스프링 MVC 동작과 밀접한 기능

웹 전반 → 필터
스프링 컨텍스트 내부의 로직 → 인터셉터

---

🧠 마무리

스프링의 발전으로 필터도 스프링 빈으로 등록할 수 있게 되었지만,
둘의 책임과 관심사는 여전히 구분되어야 한다.

기준을 명확하게 정하고 사용하자!

---

🎥 출처

📺 조시, 쿤의 테코톡: 서블릿 필터 & 스프링 인터셉터