...
Eroare Spring Boot · Apeluri între servicii și Spring Cloud

No instances available for stocc

Pe scurt

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 de stoc;
  • 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

Greșit
JAVA
.uri("http://stocc/stoc/{cod}", cod)
Corect
JAVA
.uri("http://stoc/stoc/{cod}", cod)

Numele trebuie să fie exact spring.application.name al serviciului țintă.

2Alt nume în serviciul țintă

Greșit
JAVA
# în stoc: spring.application.name=stoc-service
Corect
JAVA
# în stoc: spring.application.name=stoc

Alege un nume și folosește-l la fel peste tot.

3Nume scris de mână în mai multe locuri

Greșit
JAVA
.uri("http://stoc/...")  // în 5 clase
Corect
JAVA
@Value("${servicii.stoc}") String stoc;  // servicii.stoc=http://stoc

Un singur loc pentru nume elimină greșelile de scriere.

Repară tu

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.

Codul care dă eroarea
JAVA
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);
        }
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • java.lang.IllegalStateException: No instances available for stocc
  • Load balancer does not contain an instance for the service stocc
  • feign.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

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.