[장고 에러] "Middleware object is not callable" 해결 방법

최근 장고 프로젝트에서 사용자의 모바일 접속을 식별하는 미들웨어를 추가한 후 "Middleware object is not callable" 에러가 발생하는 문제를 겪었습니다.

이 오류는 장고의 미들웨어 구조를 제대로 이해하고 구현하지 못한 경우에 자주 발생합니다. 최신 버전의 장고(1.10 이상)에서는 미들웨어 작성 방식에 변화가 있었기 때문에, 이전 방식으로 작성된 미들웨어는 호환성 문제가 생길 수 있습니다.

이 글에서는 문제의 원인과 함께 해결 방법을 구체적으로 다루겠습니다.

미들웨어 개념 설명

미들웨어(Middleware)는 장고의 요청(request)과 응답(response) 처리 과정에 개입하여 다양한 기능을 수행하는 클래스입니다. 예를 들어, 사용자의 인증 상태를 확인하거나, 로그를 기록하는 등의 작업을 할 수 있습니다. 미들웨어는 설정 파일에 정의된 순서에 따라 실행되며, 각 미들웨어는 요청을 받아 처리한 후 다음 미들웨어로 전달하거나, 요청을 직접 처리할 수도 있습니다.

오류의 원인 분석

"Middleware object is not callable" 에러는 미들웨어 객체가 호출 가능하지 않을 때 발생합니다. 이는 미들웨어 클래스에 __call__ 메서드가 없기 때문입니다. 최신 장고 버전에서는 미들웨어 클래스가 반드시 __call__ 메서드를 포함해야 하며, 이 메서드는 요청을 인수로 받아 응답을 반환해야 합니다. 이전 버전의 스타일로 작성된 미들웨어는 process_request와 process_response 메서드를 사용하지만, 이는 최신 버전과 호환되지 않습니다.

해결 방법: __call__ 메서드 추가

문제를 해결하려면 미들웨어 클래스에 __call__ 메서드를 추가해야 합니다. 이 메서드는 요청을 받아 적절한 응답을 반환하는 역할을 합니다. 다음은 오류를 해결하기 위한 미들웨어 클래스의 예시입니다.

class SimpleMiddleware:

    def __init__(self, get_response):
        self.get_response = get_response
        # 한 번만 설정되고 초기화되는 코드

    def __call__(self, request):
        # 뷰 및 나중에 호출될 다른 미들웨어가 실행되기 전에 실행되는 코드
        response = self.get_response(request)
        # 뷰가 호출된 후에 각 요청/응답에 대해 실행되는 코드
        return response

__init__ 메서드: 미들웨어 클래스의 초기화 메서드로, get_response를 매개변수로 받아 저장합니다. 이 메서드는 미들웨어가 설정될 때 한 번만 실행됩니다.

__call__ 메서드: 요청을 받아 처리하고 응답을 반환하는 메서드입니다. 이 메서드는 각 요청마다 호출되며, 미들웨어의 핵심 로직이 포함됩니다. 여기서 get_response(request)를 호출하여 다음 미들웨어 또는 뷰를 호출하고, 응답을 처리한 후 반환합니다.

이처럼 미들웨어 클래스에 __call__ 메서드를 추가함으로써, 최신 장고 버전과 호환되도록 미들웨어를 수정할 수 있습니다.

결론

"Middleware object is not callable" 에러는 장고의 미들웨어 구조 변경에 따라 발생하는 대표적인 문제입니다. 미들웨어 클래스에 __call__ 메서드를 추가함으로써, 최신 장고 버전에서 요구하는 호출 가능 객체로 만들어 문제를 해결할 수 있습니다. 이 글에서 설명한 내용을 참고하여 자신의 프로젝트에 적용하면, 이와 같은 오류를 손쉽게 해결할 수 있을 것입니다. 장고의 미들웨어 구조를 이해하고 올바르게 구현하는 것은 보다 안정적이고 효율적인 웹 애플리케이션 개발에 중요한 요소입니다.