프로젝트를 진행하던 중 우연히 HTTP 요청을 보내야 할 일이 생겼다. HTTP 클라이언트로는 일반적으로 RestTemplate이나 WebClient를 많이 사용하지만, 넷플릭스에서 개발한 FeignClient에 흥미가 생겨 직접 적용해보았다.

📌 FeignClient

넷플릭스에서 개발한 HTTP Client로, 원래는 Spring Cloud Netflix Feign의 일부였지만, 이후 넷플릭스가 유지보수에서 손을 떼면서 현재는 OpenFeign이라는 이름으로 커뮤니티 주도의 오픈 소스 프로젝트로 전환되었다. Spring Cloud는 여전히 이를 통합해 사용하고 있으며, 선언형 방식으로 HTTP 요청을 작성할 수 있어 코드의 간결성과 가독성을 높이는 데 유용하다.

MSA의 서비스들이 많아지면서 각각의 서비스들 사이에 통신이 많아지게 되었는데, 이때 FeignClient를 적용하면 기존 방식들보다 조금 더 편리하게 사용 할 수 있다. 그리고 코드의 중복도 줄일 수 있다.

의존성

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:2025.0.0"
    }
}

implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'

스프링부트와의 호환성 주의!!

@SpringBootApplication
@EnableFeignClients(basePackages = "com.deal4u.fourplease.domain.payment")
public class FourPleaseBeApplication {

    public static void main(String[] args) {
        SpringApplication.run(FourPleaseBeApplication.class, args);
    }
}

@EnableFeignClients 어노테이션을 붙여주면 되는데 필요에 따라 범위를 지정 가능하다.

@FeignClient(
        name = "tossClient",
        url = "https://api.tosspayments.com",
        configuration = TossFeignConfig.class
)
public interface TossApiClient {

    @PostMapping("/v1/payments/confirm")
    TossPaymentConfirmResponse confirmPayment(
            @RequestBody
            TossPaymentConfirmRequest request
    );
}

@Configuration
public class TossFeignConfig {

    @Value("${toss.secret-key}")
    private String secretKey;

    @Bean
    public RequestInterceptor requestInterceptor() {
        return requestTemplate -> {
            String encodedKey = Base64.getEncoder().encodeToString((secretKey + ":").getBytes());
            requestTemplate.header("Authorization", "Basic " + encodedKey);
            requestTemplate.header("Content-Type", "application/json");
        };
    }
}

내 프로젝트에서는 외부 결제 API인 토스페이먼츠 API를 호출해야 하는 로직이 필요했다. 따라서 HTTP 요청을 보다 선언적이고 간결하게 작성할 수 있는 FeignClient를 활용해 구현했다. 위 예시는 /v1/payments/confirm 엔드포인트로 결제 승인 요청을 보내는 인터페이스이며, TossFeignConfig를 통해 인증 헤더와 Content-Type 등을 전역 설정으로 지정했다. 이처럼 외부 API 연동 시 필요한 공통 헤더를 RequestInterceptor에서 처리함으로써 코드의 재사용성과 유지보수성을 높일 수 있었다.