Feign Client hatası neden oluşur? Spring Boot ve Microservice projelerinde görülen Feign Client hatasının nedenlerini ve kesin çözüm yöntemlerini adım adım öğrenin.

Feign Client Hatası Oluştu: Nedenleri ve Çözüm Yöntemleri

Microservice mimarisi kullanan Spring Boot projelerinde Feign Client hatası, geliştiricilerin en sık karşılaştığı problemlerden biridir. Servisler arasında iletişim kurulamadığında, yanlış yapılandırma yapıldığında veya ağ bağlantısında sorun yaşandığında bu hata ortaya çıkabilir.

Bu rehberde Feign Client hatasının neden oluştuğu, nasıl çözülebileceği ve tekrar yaşanmaması için uygulanabilecek yöntemler ayrıntılı şekilde açıklanmıştır.

Feign Client Hatası Nedir?

Feign Client, Spring Cloud tarafından sunulan ve HTTP isteklerini kolaylaştıran deklaratif (declarative) bir REST istemcisidir.

Normal şartlarda servisler aşağıdaki şekilde birbirleriyle haberleşir:

• Kullanıcı isteği gönderir.
• API Gateway isteği yönlendirir.
• Feign Client ilgili servise HTTP isteği yapar.
• Servis yanıt döndürür.

Ancak bu süreçte herhangi bir hata meydana geldiğinde aşağıdaki türde mesajlar görülebilir.

FeignException
Connection refused
Read timed out
503 Service Unavailable
404 Not Found
500 Internal Server Error

Feign Client Hatası Neden Oluşur?

Bu hatanın tek bir sebebi bulunmaz. Genellikle yapılandırma veya bağlantı problemleri nedeniyle ortaya çıkar.

1. Karşı Servis Çalışmıyor

En yaygın nedenlerden biri hedef servisin kapalı olmasıdır.

Örneğin;

• Order Service durmuş olabilir.
• User Service başlamamış olabilir.
• Docker container kapanmış olabilir.

Bu durumda Feign Client bağlantı kuramaz.

Çözüm:

• Servisin çalıştığından emin olun.
• Docker kullanıyorsanız container durumunu kontrol edin.
• Kubernetes kullanıyorsanız pod durumlarını inceleyin.

2. Yanlış URL Tanımlanmış

Feign Client içerisinde yanlış adres kullanılmış olabilir.

Yanlış örnek:

@FeignClient(name="user-service", url="http://localhost:9091")

Doğru port farklıysa bağlantı kurulamaz.

Çözüm olarak;

• URL’yi kontrol edin.
• Port numarasını doğrulayın.
• HTTP yerine HTTPS kullanılması gerekip gerekmediğini inceleyin.

3. Service Discovery Problemleri

Eureka veya Consul kullanılıyorsa servis kayıt işlemi başarısız olmuş olabilir.

Örneğin:

No instances available for user-service

Bu durumda servis discovery sisteminde görünmez.

Kontrol edilmesi gerekenler:

• Eureka Dashboard
• Consul Dashboard
• Service Registry

4. Yanlış Endpoint Kullanılması

Feign Client aşağıdaki endpoint’e istek gönderiyor olabilir.

@GetMapping("/users")

Ancak hedef servis şu endpoint’i kullanıyor olabilir.

@GetMapping("/user")

Endpoint farklı olduğu için 404 hatası alınır.

5. Timeout Sorunu

Karşı servis geç yanıt verdiğinde timeout oluşabilir.

Örnek hata:

Read timed out

Çözüm:

feign.client.config.default.connectTimeout=5000
feign.client.config.default.readTimeout=10000

Timeout değerleri artırıldıktan sonra sorun büyük ölçüde çözülebilir.

6. DNS Problemleri

Docker veya Kubernetes ortamında servis adı çözümlenemeyebilir.

Örneğin:

UnknownHostException

Bu durumda DNS ayarlarının kontrol edilmesi gerekir.

7. SSL Sertifika Sorunları

HTTPS kullanan sistemlerde aşağıdaki hata görülebilir.

SSLHandshakeException

Bu hata genellikle:

• Sertifikanın geçersiz olması
• Self Signed Certificate
• TrustStore eksikliği

nedeniyle oluşur.

8. Yetkilendirme (Authentication) Problemleri

JWT Token veya API Key gönderilmiyorsa servis isteği reddedebilir.

Örneğin:

401 Unauthorized

veya

403 Forbidden

Bu durumda Authorization Header doğru şekilde eklenmelidir.

Feign Client Hatası Nasıl Çözülür?

Sorunu çözmek için aşağıdaki adımlar sırasıyla uygulanabilir.

Servisin Çalıştığını Kontrol Edin

İlk olarak hedef servisin aktif durumda olduğu doğrulanmalıdır.

Linux:

systemctl status

Docker:

docker ps

Kubernetes:

kubectl get pods

URL Ayarlarını Kontrol Edin

application.yml dosyasında bulunan adreslerin doğru olduğundan emin olun.

Örnek:

user-service:
  url: http://localhost:8081

Feign Client Yapısını İnceleyin

Örnek kullanım:

@FeignClient(name="user-service")
public interface UserClient {

@GetMapping("/users/{id}")
User getUser(@PathVariable Long id);

}

İsimlerin ve endpoint’lerin birebir aynı olması gerekir.

Logları İnceleyin

Spring Boot logları çoğu zaman sorunun kaynağını açıkça gösterir.

Örneğin:

Connection refused

veya

404 NOT FOUND

Log seviyesini artırabilirsiniz.

logging.level.org.springframework.cloud.openfeign=DEBUG

Timeout Ayarlarını Güncelleyin

Uzun süren işlemler için timeout artırılabilir.

feign:
  client:
    config:
      default:
        connectTimeout: 5000
        readTimeout: 15000

Retry Mekanizmasını Kullanın

Geçici ağ sorunlarında otomatik tekrar denemesi faydalı olabilir.

@Bean
Retryer retryer() {
return new Retryer.Default();
}

Bu yöntem kısa süreli bağlantı sorunlarında başarı oranını artırır.

Feign Client Hatası Alırken Kontrol Edilmesi Gerekenler

Sorun giderme sürecinde aşağıdaki kontrollerin yapılması önerilir:

• Servis çalışıyor mu?
• URL doğru mu?
• Port doğru mu?
• Endpoint doğru mu?
• Eureka kaydı var mı?
• JWT Token gönderiliyor mu?
• Firewall bağlantıyı engelliyor mu?
• Docker ağı doğru yapılandırılmış mı?
• Timeout süresi yeterli mi?
• SSL sertifikası geçerli mi?

Bu adımlar sistematik olarak incelendiğinde hata kaynağı daha hızlı bulunabilir.

Feign Client Hatası Nasıl Önlenir?

Benzer sorunların tekrar yaşanmaması için şu uygulamalar önerilir:

• Service Discovery yapısını düzenli olarak izleyin.
• Health Check mekanizması kullanın.
• Circuit Breaker (Resilience4j) ekleyin.
• Retry politikalarını doğru yapılandırın.
• Merkezi loglama sistemi kullanın.
• Timeout değerlerini uygulamanıza uygun şekilde belirleyin.
• API sürümlerini uyumlu tutun.
• Servislerin sağlık durumunu otomatik olarak takip edin.

Bu önlemler, özellikle büyük ölçekli mikroservis mimarilerinde sistem kararlılığını artırır.

Sık Sorulan Sorular

Feign Client hatası neden oluşur?

Genellikle servisin çalışmaması, yanlış URL, yanlış endpoint, timeout, SSL sertifika problemi veya Service Discovery yapılandırma hataları nedeniyle oluşur.

Connection Refused hatası ne anlama gelir?

Feign Client’ın hedef servise bağlanamadığını gösterir. Servis kapalı olabilir veya yanlış port kullanılıyor olabilir.

Read Timed Out hatası nasıl çözülür?

Bağlantı veya okuma zaman aşımı süresi artırılabilir. Ayrıca hedef servisin performansı ve ağ gecikmesi de kontrol edilmelidir.

No Instances Available for Service hatası neden alınır?

Bu hata, Service Discovery (örneğin Eureka) üzerinde ilgili servisin kayıtlı olmadığını veya erişilemediğini gösterir.

Feign Client timeout değeri nasıl değiştirilir?

application.yml veya application.properties dosyasında connectTimeout ve readTimeout değerleri güncellenerek değiştirilebilir.

Sonuç

Feign Client hatası, mikroservis tabanlı Spring Boot projelerinde sık karşılaşılan ancak doğru analiz edildiğinde kolayca çözülebilen bir problemdir. Sorunun kaynağı çoğunlukla servis erişimi, yapılandırma, ağ bağlantısı veya güvenlik ayarlarından kaynaklanır. Servis durumunun doğrulanması, URL ve endpoint eşleşmelerinin kontrol edilmesi, timeout ayarlarının optimize edilmesi ve log kayıtlarının incelenmesi sayesinde hata kısa sürede giderilebilir. Ayrıca Health Check, Retry ve Circuit Breaker gibi dayanıklılık mekanizmalarının kullanılması, benzer sorunların gelecekte yaşanma olasılığını önemli ölçüde azaltacaktır.

Bu yazımız da hoşuna gidebilir! A Java Exception Has Occurred Hatası Nedir? (2026 Kesin Çözüm Rehberi)