OpenFeign GET 요청 시 405 Method Not Allowed 오류의 근본 원인 분석 및 해결 방안

핵심 기술: OpenFeign에서 GET 요청 시 @RequestParam과 같은 HTTP 바인딩 어노테이션 누락으로 인해 발생하는 405 Method Not Allowed 오류의 원인을 HTTP 표준 및 클라이언트 구현체의 레거시 호환성 측면에서 심층 분석하고 해결책을 제시합니다.

기술적 세부사항:
* 문제 발생 메커니즘: GET 요청 시 파라미터에 @RequestParam 등 HTTP 바인딩 어노테이션이 없을 경우, OpenFeign이 사용하는 HttpURLConnection이 요청 본문(body)이 있는 GET 요청을 RFC 7231 규약에 따라 호환성 유지를 위해 POST로 자동 변환하는 현상.
* 로그 분석을 통한 단서 포착: 클라이언트(A 서버)에서는 GET으로 요청했으나, 실제 서버(B 서버)에서는 POST로 수신되는 상황을 로그를 통해 확인하며 문제 원인을 추적.
* HttpURLConnection의 레거시 호환성: 과거 GET 요청에 본문을 포함시키는 사례와 기존 코드의 파괴를 막기 위해 HttpURLConnection이 암묵적으로 POST로 전환하는 우회 로직 작동.
* 해결 방안 1: 명시적인 어노테이션 사용: GET 메서드 사용 시 반드시 @RequestParam, @PathVariable 등 적절한 HTTP 바인딩 어노테이션을 사용하여 Feign이 요청 파라미터를 올바르게 처리하도록 함.
* 해결 방안 2: HTTP 클라이언트 변경: feign-hc5 라이브러리를 사용하여 Apache HttpClient 5를 사용하면 GET 요청의 본문 포함 시에도 메서드를 변경하지 않아 원인 해결 가능 (단, 사이드 이펙트 고려 필요).
* 로깅 레벨의 중요성: DEBUG 로깅 레벨에서 HttpURLConnection의 내부 동작 로그를 확인할 수 있으나, 일반적으로 INFO 레벨만 사용하는 경우 중요한 힌트를 놓칠 수 있음.
* spring-cloud-openfeign의 기여: SpringMvcContract.java의 parseAndValidateMetadata() 메서드 분석을 통해 GET 요청에 HTTP 바인딩 어노테이션이 없는 경우 경고 로그를 출력하도록 이슈(OpenFeign/feign Issue#2872, spring-cloud-openfeign/Issues #1191)를 제기하고 PR(PR #1194)을 통해 기여하여 문제점을 개선함.
* spring-cloud-openfeign 유지보수 모드: 2022.0.0 버전부터 유지보수 모드에 진입하여 신규 기능 개발은 중단되고 크리티컬 버그 수정 위주로 진행됨을 안내.

개발 임팩트: OpenFeign 사용 시 발생할 수 있는 예상치 못한 HTTP 메서드 변경 문제를 사전에 예방하고, 디버깅 시간을 단축하며, 라이브러리 개선에 기여하는 경험을 제공합니다. 또한, 클라이언트 라이브러리의 내부 동작 원리에 대한 이해를 높여 더욱 견고한 시스템 설계에 도움을 줍니다.

커뮤니티 반응: OpenFeign 프로젝트에 직접 이슈를 제기하고 PR을 통해 기여한 사례를 통해 커뮤니티와 협력하여 실제 문제를 해결하는 과정을 보여줍니다.