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

Not enough variable values available to expand 'cod'

Pe scurt

URI-ul are un șablon cu variabile ({cod}), dar apelul nu a primit valori pentru toate. RestClient/RestTemplate nu poate construi URL-ul. Transmite valorile în ordinea variabilelor, ca argumente după șablon, sau într-un Map cu aceleași nume.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

IllegalArgumentException: Not enough variable values available to expand 'cod' apare la construirea URL-ului, înainte ca cererea să plece. RestClient, RestTemplate și WebClient acceptă șabloane precum "/stoc/{cod}", iar valorile vin ca argumente varargs, în ordinea variabilelor, sau ca Map cu numele lor.

Cazuri tipice:

  • ai uitat argumentul: .uri("/stoc/{cod}") în loc de .uri("/stoc/{cod}", cod);
  • șablonul are două variabile, iar tu dai una;
  • ai concatenat un JSON sau un text cu acolade în URL: { e interpretat ca început de variabilă;
  • în Map, cheia diferă de numele din șablon ("id" vs {cod}).

Atenție la concatenare: "/stoc/" + cod pare să funcționeze, dar nu codifică valoarea (spații, /, ?), deci șablonul cu variabile e varianta corectă.

De ce apare: cauzele frecvente

1Lipsește valoarea

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

Valoarea vine după șablon, ca argument.

2Cheie diferită în Map

Greșit
JAVA
.uri("/stoc/{cod}", Map.of("id", cod))
Corect
JAVA
.uri("/stoc/{cod}", Map.of("cod", cod))

Cheile Map-ului trebuie să fie numele din acolade.

3Acolade în parametri

Greșit
JAVA
.uri("/cauta?filtru={\"x\":1}")
Corect
JAVA
.uri("/cauta?filtru={f}", "{\"x\":1}")

Textul cu acolade se transmite ca valoare, nu în șablon.

Repară tu

Repară eroarea, direct în pagină

Apelul către serviciul de stoc eșuează: în proiectul real, cu Not enough variable values available to expand 'cod'. Șablonul URI are variabila {cod}, dar StocClient nu-i dă nicio valoare. Transmite codul primit ca argument, după șablon.

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.*;

/* 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);
    }

    @Service
    static class StocClient {
        private final RestClient http = RestClient.builder().baseUrl("http://localhost:8081").build();

        Stoc stoc(String cod) {
            return http.get().uri("/stoc/{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

Valorile variabilelor vin după șablon: .uri("/stoc/{cod}", cod).

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: Not enough variable values available to expand 'cod'
  • Map has no value for 'cod'
  • java.lang.IllegalArgumentException: Not enough variable values available to expand 'id'

Cum o eviți pe viitor

  • Folosește mereu șabloane cu variabile, nu concatenare.
  • Verifică numărul de acolade și numărul de argumente în același loc.
  • Pentru multe variabile, folosește un Map cu nume explicite.
  • Testează fiecare client cu un apel real către un mock (MockRestServiceServer, WireMock).

Întrebări frecvente

De ce nu folosesc concatenarea?

Concatenarea nu codifică valorile: un cod cu spațiu sau cu / produce un URL greșit. Șablonul le codifică automat.

Pot amesteca varargs și Map?

Nu în același apel: alegi una dintre forme.

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.