Not enough variable values available to expand 'cod'
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
.uri("/stoc/{cod}").uri("/stoc/{cod}", cod)Valoarea vine după șablon, ca argument.
2Cheie diferită în Map
.uri("/stoc/{cod}", Map.of("id", cod)).uri("/stoc/{cod}", Map.of("cod", cod))Cheile Map-ului trebuie să fie numele din acolade.
3Acolade în parametri
.uri("/cauta?filtru={\"x\":1}").uri("/cauta?filtru={f}", "{\"x\":1}")Textul cu acolade se transmite ca valoare, nu în șablon.
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.
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);
}
}
}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).
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.*;
/* 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}", 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
Șablonul "/stoc/{cod}" are o variabilă, deci are nevoie de o valoare. Fără ea, Spring nu poate construi URL-ul și aruncă excepția înainte să trimită cererea. Acum codul primit în ruta magazinului e transmis ca argument și e și codificat corect, dacă ar conține caractere speciale.
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
Mapcu 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
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ă. HttpClientErrorException$NotFound: 404 Not Found: "{"status":404,"error":"Not Found","path":"/stoc/Z9"}" Serviciul apelat a răspuns 404, iar RestClient/RestTemplate transformă orice răspuns 4xx într-o excepție HttpClientErrorException. Neprinsă, devine 500 în serviciul tău. Verifică URL-ul apelat și tratează 404 explicit (try/catch sau onStatus), răspunzând clientului tău cu 404. Could not extract response: no suitable HttpMessageConverter found for response type [class Stoc] and content type [text/plain;charset=UTF-8] Clientul HTTP a primit un răspuns pe care nu-l poate transforma în tipul cerut: de obicei text sau HTML în loc de JSON, ori un JSON cu altă structură. Verifică URL-ul (poate nimerește o pagină sau alt endpoint) și ce întoarce efectiv serviciul apelat. Î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.
