No instances available for stocc
Load balancer-ul a primit un nume de serviciu, dar registrul de servicii nu are nicio instanță pornită cu acel nume. Fie numele din URL e scris greșit, fie serviciul nu s-a înregistrat (nu rulează, alt spring.application.name, alt registru). Compară numele cu cel din Eureka.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
IllegalStateException: No instances available for stocc (sau, în versiunile noi, 503 Service Unavailable cu Load balancer does not contain an instance for the service stocc) apare la un client @LoadBalanced sau Feign: numele din URL a fost căutat în registrul de servicii, iar lista de instanțe a venit goală.
Cauze:
- greșeală de scriere în URL sau în
@FeignClient(name = ...):stoccîn loc destoc; - serviciul are alt
spring.application.name(de exemplu,stoc-service); - serviciul nu rulează sau încă nu s-a înregistrat (Eureka propagă înregistrările cu o întârziere de până la câteva zeci de secunde);
- serviciile folosesc registre diferite, ori
eureka.client.register-with-eureka=false.
Verifică pagina Eureka (http://localhost:8761): numele serviciilor apar acolo, scrise cu majuscule, și trebuie să coincidă cu cel din URL, fără să conteze majusculele.
De ce apare: cauzele frecvente
1Nume greșit în URL
.uri("http://stocc/stoc/{cod}", cod).uri("http://stoc/stoc/{cod}", cod)Numele trebuie să fie exact spring.application.name al serviciului țintă.
2Alt nume în serviciul țintă
# în stoc: spring.application.name=stoc-service# în stoc: spring.application.name=stocAlege un nume și folosește-l la fel peste tot.
3Nume scris de mână în mai multe locuri
.uri("http://stoc/...") // în 5 clase@Value("${servicii.stoc}") String stoc; // servicii.stoc=http://stocUn singur loc pentru nume elimină greșelile de scriere.
Repară eroarea, direct în pagină
Magazinul folosește un client @LoadBalanced, dar apelul eșuează: în proiectul real, cu No instances available for stocc. Serviciul de stoc rulează cu spring.application.name=stoc. Corectează numele din URL-ul folosit de StocClient, ca stocul pentru A1 să ajungă la magazin.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.*;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
/* StocApp.properties
spring.application.name=stoc
server.port=8081
*/
/* MagazinApp.properties
server.port=8080
server.error.include-message=always
*/
record Stoc(String cod, int bucati) { }
@SpringBootApplication
class StocApp {
public static void main(String[] args) {
SpringApplication.run(StocApp.class, args);
}
@RestController
static class StocController {
private final Map<String, Integer> stoc = Map.of("A1", 5, "B2", 0);
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable String cod) {
Integer n = stoc.get(cod);
if (n == null) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Cod necunoscut: " + cod);
}
return new Stoc(cod, n);
}
}
}
@SpringBootApplication
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@Bean
@LoadBalanced
RestClient.Builder restClientBuilder() {
return RestClient.builder();
}
@Service
static class StocClient {
private final RestClient http;
StocClient(RestClient.Builder builder) {
this.http = builder.build();
}
Stoc stoc(String cod) {
return http.get().uri("http://stocc/stoc/{cod}", cod).retrieve().body(Stoc.class);
}
}
@RestController
static class ProdusController {
private final StocClient stoc;
ProdusController(StocClient stoc) {
this.stoc = stoc;
}
@GetMapping("/produse/{cod}/stoc")
Stoc stoc(@PathVariable String cod) {
return stoc.stoc(cod);
}
}
}Tomcat started on port 8081 (http)
Started StocApp
Tomcat started on port 8080 (http)
Started MagazinApp
GET /produse/A1/stoc → 200
{"cod":"A1","bucati":5}Indiciu
Compară numele din URL cu spring.application.name din StocApp.properties.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.*;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
/* StocApp.properties
spring.application.name=stoc
server.port=8081
*/
/* MagazinApp.properties
server.port=8080
server.error.include-message=always
*/
record Stoc(String cod, int bucati) { }
@SpringBootApplication
class StocApp {
public static void main(String[] args) {
SpringApplication.run(StocApp.class, args);
}
@RestController
static class StocController {
private final Map<String, Integer> stoc = Map.of("A1", 5, "B2", 0);
@GetMapping("/stoc/{cod}")
Stoc stoc(@PathVariable String cod) {
Integer n = stoc.get(cod);
if (n == null) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Cod necunoscut: " + cod);
}
return new Stoc(cod, n);
}
}
}
@SpringBootApplication
class MagazinApp {
public static void main(String[] args) {
SpringApplication.run(MagazinApp.class, args);
}
@Bean
@LoadBalanced
RestClient.Builder restClientBuilder() {
return RestClient.builder();
}
@Service
static class StocClient {
private final RestClient http;
StocClient(RestClient.Builder builder) {
this.http = builder.build();
}
Stoc stoc(String cod) {
return http.get().uri("http://stoc/stoc/{cod}", cod).retrieve().body(Stoc.class);
}
}
@RestController
static class ProdusController {
private final StocClient stoc;
ProdusController(StocClient stoc) {
this.stoc = stoc;
}
@GetMapping("/produse/{cod}/stoc")
Stoc stoc(@PathVariable String cod) {
return stoc.stoc(cod);
}
}
}De ce merge
Load balancer-ul caută instanțele după numele din URL, iar serviciul de stoc s-a înregistrat ca stoc. Cu un c în plus, registrul nu găsea nicio instanță. Cu numele corect, cererea ajunge la localhost:8081. Ca să eviți astfel de greșeli, ține numele serviciului într-o singură proprietate.
Alte forme ale mesajului
java.lang.IllegalStateException: No instances available for stoccLoad balancer does not contain an instance for the service stoccfeign.FeignException$ServiceUnavailable: [503] during [GET] to [http://stocc/stoc/A1]
Cum o eviți pe viitor
- Păstrează numele serviciilor într-un singur loc (proprietăți sau constante).
- Verifică în panoul Eureka că serviciul s-a înregistrat cu numele așteptat.
- La pornire, tolerează câteva secunde fără instanțe (retry), cât durează înregistrarea.
- Scrie un test de integrare care apelează serviciul prin numele lui.
Întrebări frecvente
Serviciul rulează, dar eroarea apare totuși. De ce?
Probabil nu s-a înregistrat încă în Eureka sau s-a înregistrat cu alt nume. Verifică panoul Eureka și spring.application.name.
Contează majusculele în numele serviciului?
Nu. Eureka afișează numele cu majuscule, dar rezolvarea nu ține cont de ele.
Erori înrudite
I/O error on GET request for "http://stoc/stoc/A1": stoc Clientul a apelat un serviciu după numele lui logic (http://stoc/...), dar fără load balancer numele e tratat ca un nume de gazdă DNS, care nu există (UnknownHostException). Pune @LoadBalanced pe bean-ul RestClient.Builder sau RestTemplate și construiește clientul din acel bean. FeignException$NotFound: [404 Not Found] during [GET] to [http://localhost:8081/stoc/Z9] [StocClient#stoc(String)] Clientul Feign a primit 404 de la serviciul apelat și, implicit, aruncă FeignException$NotFound. Neprinsă, devine 500 în serviciul tău. Verifică ruta din interfața @FeignClient și tratează resursa lipsă: prinde excepția, folosește dismiss404 sau un ErrorDecoder propriu. I/O error on GET request for "http://localhost:8082/stoc/A1": Connection refused Clientul HTTP (RestClient, RestTemplate, Feign) nu s-a putut conecta la serviciul apelat: la adresa și portul din URL nu ascultă nimic. Serviciul e oprit, portul sau gazda sunt greșite, ori în Docker folosești localhost în loc de numele containerului. Verifică URL-ul și că serviciul rulează. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
