Filter 개념과 동작 원리

leejihyeon·2026년 5월 4일

Filter란 무엇인가?

DispatcherServlet에 요청이 전달되기 전후에 URL 패턴에 맞는 요청에 대해 부가적인 작업을 처리할 수 있는 기능을 제공한다.
애플리케이션을 실행하기 전에 먼저 검증한다.
스프링 컨테이너가 아닌 톰캣과 같은 웹 컨테이너(서블릿 컨테이너)에서 동작하는 것이 핵심이다.

필터의 주요 역할

보통 비즈니스 로직과 분리되어 공통적으로 처리해야 하는 작업들을 맡는다.

보안 및 인증 : 유효한 사용자인지 확인(예 : JWT 토큰 검증)
로깅 : 어떤 IP에서 어떤 요청이 왔는지 기록
인코딩 변환 : 모든 요청의 인코딩을 UTF-8로 일괄 설정
데이터 압축 및 암호화

Filter를 쓰는 이유

공통 관심사(Cross-Cutting Concerns)

필터가 등장한 이유 : 공통 관심사(Cross-Cutting Concerns)
우리가 서비스를 만들다 보면, 비즈니스 로직(핵심 기능)외에도 반복적으로 수행해야 하는 부가 기능들이 생긴다.
- 핵심 기능 : 게시글 작성, 수정, 삭제(비즈니스 로직)
- 부가 기능 : 로그인 여부 확인, 로그 남기기, 인코딩 처리 등(비지니스 로직과는 별개로 동작하는 기능)

❌ 필터를 안 쓴다면?

로그인이 필요한 모든 컨트롤러 메서드마다 로그인 검증 로직을 넣어야 한다.

코드 중복 : 수십 개의 메서드에 같은 코드가 들어간다.
유지보수 지옥 : 로그인 로직이 조금이라도 바뀌면 모든 메서드를 찾아가서 수정해야 한다.
실수 유발 : 하나라도 빼먹으면 보안 구멍이 생긴다.

코드 예시

@RestController
@RequestMapping("/post")
public class PostController {

    @PostMapping
    public PostResponseDto create(PostCreateRequestDto request) {
        // 로그인 여부 확인 로직
        // 생성 로직
    }

    @PutMapping("/{postId}")
    public void update(
            @PathVariable Long postId,
            PostUpdateRequestDto request
    ) {
        // 로그인 여부 확인 로직
        // 수정 로직
    }

    @DeleteMapping("/{postId}")
    public void delete(@PathVariable Long postId) {
        // 로그인 여부 확인 로직
        // 삭제 로직
    }

}

위의 코드에서 공통으로 관심이 있는 부분을 공통 관심사라고 한다.
로그인 여부 확인 로직 -> 공통 관심사 (인증 : 로그인)

이를 해결하기 위해서 Servlet Filter를 사용한다.

Servlet Filter

servlet Filter 적용

- Filter를 적용하면 Servlet이 호출되기 이전에 Filter를 항상 거치게 된다. - 공통 관심사를 필터에만 적용하면 모든 요청 or 응답에 적용된다. - Filter는 특정 URL Pattern에 적용할 수 있다. - Spring을 사용하는 경우 Servlet은 Dispatcher Servlet이다.