Erori Spring Boot explicate: ce înseamnă și cum le repari
Mesajele de eroare Spring Boot pe care le primești cel mai des, fiecare explicat pe înțeles: ce înseamnă, de ce apare, cod greșit lângă cod corect și cum o repari. Înveți de la zero cu Curs Spring Boot și REST API: primele 18 lecții sunt gratuite.
Pagină coordonată de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
- 148erori
- 13capitole
- 73ușor
- 69mediu
- 6greu
Spring Boot face multe lucruri automat: creează bean-urile, le injectează, citește configurarea, pornește Tomcat și transformă excepțiile în răspunsuri HTTP. Când ceva nu se potrivește, mesajele de eroare sunt lungi și pline de nume interne (UnsatisfiedDependencyException, Servlet.service(), HttpMessageNotReadableException), iar rândul cu adevărat util e adesea îngropat în mijlocul stivei. Aici găsești erorile pe care le întâlnești cel mai des, de la aplicația care nu pornește până la răspunsurile 400, 404, 405 sau 500 care nu par să aibă sens.
Pentru fiecare eroare explicăm ce înseamnă mesajul, din ce cauze apare de obicei (cu cod greșit și cod corect alăturat), cum o previi și cum o repari pas cu pas, într-un exercițiu pe care îl rulezi direct în pagină. Exemplele folosesc Spring Boot 3, cu pachetele jakarta.*; unde Spring Boot 2 se comportă diferit, spunem explicit.
Aplicația nu pornește: bean-uri și injectare
Field produsService in ProdusController required a bean of type 'ProdusService' that could not be found. Spring a încercat să injecteze câmpul marcat cu @Autowired, dar nu există niciun bean de tipul cerut. De obicei clasa nu are @Service / @Component sau stă în afara pachetului scanat. Adaugă adnotarea pe clasă (sau un @Bean) și aplicația pornește. Explicația completă → Ușor Repară tu Parameter 0 of constructor in ComandaService required a bean of type 'StocService' that could not be found. Constructorul unui bean cere un parametru (aici primul, indexul 0) pentru care Spring nu are niciun bean de tipul respectiv. Fă clasa dependenței bean (@Service, @Component sau o metodă @Bean) sau corectează tipul parametrului. Explicația completă → Ușor Repară tu Parameter 0 of constructor in CatalogClient required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found. Spring Boot nu creează automat un RestTemplate, ci doar un RestTemplateBuilder. Declară o metodă @Bean care întoarce RestTemplate (de exemplu builder.build()) într-o clasă @Configuration, apoi injectează-l. Explicația completă → Mediu Repară tu Parameter 0 of constructor in ComandaController required a single bean, but 2 were found Spring trebuie să injecteze un singur obiect de un tip (de obicei o interfață), dar a găsit două bean-uri care se potrivesc. Marchează implementarea implicită cu @Primary sau cere-o explicit cu @Qualifier("numeBean"). Explicația completă → Mediu Repară tu The dependencies of some of the beans in the application context form a cycle Două sau mai multe bean-uri depind unul de altul în cerc (A cere B, B cere A), iar Spring Boot (de la 2.6) refuză dependențele circulare. Rupe cercul: mută logica comună într-o a treia clasă sau elimină dependența inutilă. Explicația completă → Mediu Repară tu UnsatisfiedDependencyException: Error creating bean with name 'raportController': Unsatisfied dependency expressed through constructor parameter 0 Spring nu a putut crea bean-ul din mesaj pentru că una dintre dependențele lui (parametrul indicat) nu a putut fi rezolvată. Citește cauza din finalul stivei (No qualifying bean, alt bean care nu se creează) și repar-o acolo. Explicația completă → Mediu Repară tu NoSuchBeanDefinitionException: No qualifying bean of type 'Notificator' available Ai cerut containerului un bean de un tip pentru care nu există niciunul (de obicei cu getBean sau în timpul injectării). Creează bean-ul (@Component, @Bean) sau verifică dacă e condiționat de un profil ori de o proprietate care nu e activă. Explicația completă → Mediu Repară tu NoUniqueBeanDefinitionException: No qualifying bean of type 'Curier' available: expected single matching bean but found 2: curierRapid,curierEconomic Ai cerut un singur bean de un tip, dar containerul are două. Alege unul: marchează-l @Primary, cere-l după nume (getBean("curierRapid", Curier.class) sau @Qualifier) ori ia-le pe toate cu getBeansOfType / List. Explicația completă → Mediu Repară tu BeanCreationException: Error creating bean with name 'catalogService': Invocation of init method failed Metoda de inițializare a unui bean (de obicei cea cu @PostConstruct) a aruncat o excepție, așa că Spring nu a putut termina crearea lui și oprește aplicația. Citește cauza din Caused by și fă inițializarea să trateze cazul respectiv. Explicația completă → Mediu Repară tu Failed to instantiate [CursValutar]: Factory method 'cursValutar' threw exception with message: Cursul trebuie să fie pozitiv O metodă @Bean (metoda „fabrică”) a aruncat o excepție când Spring a apelat-o, deci bean-ul nu s-a creat și aplicația s-a oprit. Mesajul de după „with message” spune motivul: repară datele sau configurarea folosite în metodă. Explicația completă → Mediu Repară tu Failed to instantiate [RaportService]: No default constructor found Clasa are mai mulți constructori și niciunul nu e marcat cu @Autowired, așa că Spring caută un constructor fără parametri, care nu există. Păstrează un singur constructor sau marchează-l cu @Autowired pe cel folosit pentru injectare. Explicația completă → Ușor Repară tu Cannot invoke "StocService.cantitate(String)" because "this.stoc" is null Câmpul marcat cu @Autowired este null pentru că obiectul care îl conține a fost creat cu new, nu de Spring, deci injectarea nu a avut loc. Lasă Spring să creeze obiectul (fă-l bean și injectează-l) în loc să scrii new. Explicația completă → Greu Repară tu BeanCurrentlyInCreationException: Error creating bean with name 'facturaService': Requested bean is currently in creation: Is there an unresolvable circular reference? Spring a ajuns din nou la un bean pe care încă îl crea, adică există un cerc de dependențe (de obicei prin constructori sau @Autowired). Găsește cercul și rupe-l, mutând logica comună într-o clasă separată. Explicația completă → Mediu Repară tu Parameter 0 of constructor in EmailService required a bean of type 'java.lang.String' that could not be found. Constructorul unui bean are un parametru simplu (String, int), iar Spring încearcă să-l injecteze ca bean. Valorile de configurare se dau cu @Value("${cheie}") pe parametru sau prin @ConfigurationProperties, nu ca bean-uri. Explicația completă → Configurare, proprietăți și profiluri
Could not resolve placeholder 'app.magazin.nume' in value "${app.magazin.nume}" Un @Value("${cheie}") cere o proprietate care nu există în application.properties (sau în profilul activ, în variabilele de mediu). Adaugă proprietatea, corectează numele cheii sau pune o valoare implicită: ${cheie:valoare}. Explicația completă → Ușor Repară tu Web server failed to start. Port 8080 was already in use. Alt proces ascultă deja pe portul 8080 (adesea o instanță mai veche a aceleiași aplicații sau alt serviciu), deci Tomcat nu poate porni. Oprește procesul vechi sau pornește aplicația pe alt port cu server.port=8081. Explicația completă → Mediu Repară tu Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'app.paginare' to PaginareProps failed O clasă @ConfigurationProperties marcată cu @Validated a primit din configurare o valoare care încalcă o regulă (@Min, @Max, @NotBlank). Mesajul arată proprietatea, valoarea și motivul (Reason): corectează valoarea din application.properties. Explicația completă → Ușor Repară tu Failed to convert value of type 'java.lang.String' to required type 'int'; For input string: "zece" O proprietate injectată cu @Value într-un câmp numeric are în configurare un text care nu e număr. Scrie în application.properties o valoare numerică (10, nu zece), fără spații sau unități, sau schimbă tipul câmpului. Explicația completă → Mediu Repară tu Failed to bind properties under 'app.plati.timeout' to java.time.Duration Valoarea unei proprietăți legate cu @ConfigurationProperties nu se poate converti în tipul câmpului, aici o durată. Duration acceptă formatele 10s, 500ms, 2m, 1h sau ISO-8601 (PT10S), nu „10 sec”. Corectează valoarea din configurare. Explicația completă → Ușor Repară tu No active profile set, falling back to 1 default profile: "default" Mesajul INFO de la pornire spune că niciun profil nu e activ, deci Spring folosește doar application.properties și ignoră application-dev.properties. Nu e o eroare; dacă ai nevoie de un profil, activează-l cu spring.profiles.active=dev. Explicația completă → Mediu Repară tu Not registered via @EnableConfigurationProperties, marked as Spring component, or scanned via @ConfigurationPropertiesScan Clasa @ConfigurationProperties nu este înregistrată ca bean, deci nu poate fi injectată (la pornire vezi „required a bean of type ... that could not be found”). Adaugă @EnableConfigurationProperties(Clasa.class) sau @ConfigurationPropertiesScan pe clasa aplicației. Explicația completă → Mediu Repară tu Bean method 'cacheProduse' in 'CacheConfig' not loaded because @ConditionalOnProperty (app.cache.activ=true) did not find property 'app.cache.activ' Un bean este creat doar dacă o proprietate are o anumită valoare (@ConditionalOnProperty), iar proprietatea lipsește. Cine îl injectează nu-l găsește. Setează proprietatea, folosește matchIfMissing = true sau oferă un bean alternativ. Explicația completă → Mediu Repară tu mapping values are not allowed here in 'reader', line 1, column 9 Fișierul application.yml are o structură greșită: două chei pe același rând sau o cheie la indentare greșită. În YAML fiecare cheie stă pe rândul ei, iar copiii sunt indentați cu spații sub părinte. Rescrie rândul indicat (line, column). Explicația completă → Ușor Repară tu found character '\t' that cannot start any token. (Do not use \t(TAB) for indentation) Fișierul application.yml este indentat cu TAB, iar YAML acceptă doar spații. Înlocuiește tab-urile cu spații (de obicei 2 pe nivel) și configurează editorul să pună spații în fișierele YAML. Explicația completă → Rute și cereri HTTP: 404, 405, 400
Whitelabel Error Page: This application has no explicit mapping for /error, so you are seeing this as a fallback. Este pagina de eroare implicită a Spring Boot, afișată în browser când cererea se termină cu o eroare (de obicei 404: nicio rută pentru adresa cerută, sau 500). Citește type și status de sub ea, apoi verifică ruta, metoda HTTP și logul aplicației. Explicația completă → Ușor Repară tu No static resource api/produse. În Spring Boot 3.2+, o cerere pentru care nu există niciun controller ajunge la handler-ul de fișiere statice, care nu găsește nimic și răspunde 404 cu NoResourceFoundException. Verifică calea, prefixul @RequestMapping de pe clasă și adnotarea @RestController. Explicația completă → Ușor Repară tu Request method 'POST' is not supported Calea există, dar nu acceptă metoda HTTP folosită (de exemplu ai doar @GetMapping, iar clientul trimite POST), deci răspunsul este 405 Method Not Allowed. Adaugă metoda potrivită (@PostMapping) sau trimite cererea cu metoda corectă. Explicația completă → Ușor Repară tu Required request parameter 'pagina' for method parameter type int is not present Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false. Explicația completă → Mediu Repară tu Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate" Valoarea din cale sau din query nu se poate converti în tipul parametrului (aici un text în loc de număr), deci Spring răspunde 400. Adesea cererea a ajuns la ruta /{id} din greșeală: verifică ruta dedicată și tipul parametrului. Explicația completă → Ușor Repară tu Required request header 'X-API-Key' for method parameter type String is not present Metoda cere un antet HTTP cu @RequestHeader, iar cererea nu îl are, deci Spring răspunde 400. Trimite antetul din client sau fă-l opțional cu required = false / defaultValue. Explicația completă → Ușor Repară tu Required request body is missing Metoda are un parametru @RequestBody, dar cererea a venit fără corp (adesea datele erau în query sau cererea era GET), deci Spring răspunde 400. Trimite JSON-ul în corpul cererii sau citește datele cu @RequestParam dacă vin în adresă. Explicația completă → Mediu Repară tu Content-Type 'text/plain;charset=UTF-8' is not supported Clientul trimite corpul cu un Content-Type pe care metoda nu îl poate citi (de exemplu text/plain la un @RequestBody care așteaptă JSON), deci Spring răspunde 415 Unsupported Media Type. Trimite antetul Content-Type: application/json sau primește textul ca String. Explicația completă → Mediu Repară tu Ambiguous mapping. Cannot map 'produsController' method ProdusController#cauta(String) to {GET [/produse]}: There is already 'produsController' bean method ProdusController#toate() mapped. Două metode sunt mapate pe exact aceeași combinație de cale și metodă HTTP, iar Spring nu pornește aplicația. Dă-le căi diferite sau combină-le într-o singură metodă (de exemplu cu un @RequestParam opțional). Explicația completă → Mediu Repară tu Ambiguous handler methods mapped for '/produse/A12': {ProdusController#dupaId(long), ProdusController#dupaCod(String)} Două rute cu variabile pe aceeași poziție (/produse/{id} și /produse/{cod}) se potrivesc la fel de bine cu cererea, iar Spring nu poate alege și răspunde 500. Dă-le forme diferite, de exemplu /produse/{id} și /produse/cod/{cod}. Explicația completă → Ușor Repară tu Missing URI template variable 'idProdus' for method parameter of type long Numele din @PathVariable nu se regăsește în calea rutei (de exemplu ruta are {id}, iar parametrul cere idProdus). Folosește același nume în ambele locuri: @GetMapping("/produse/{id}") cu @PathVariable("id"). Explicația completă → Mediu Repară tu Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDate' Un parametru din adresă (de exemplu ?data=15.03.2026) nu poate fi convertit în LocalDate, pentru că Spring acceptă implicit doar formatul ISO 2026-03-15. Răspunsul este 400. Trimite data ca 2026-03-15 sau declară formatul cu @DateTimeFormat(pattern = "dd.MM.yyyy"). Explicația completă → Ușor Repară tu Invalid value 'crescator' for orders given; Has to be either 'desc' or 'asc' (case insensitive) Sort.Direction.fromString primește doar textele asc sau desc (cu orice fel de litere). Orice altă valoare, de exemplu crescator, aruncă IllegalArgumentException, iar cererea primește 500. Transformă tu parametrul în Sort.Direction.ASC / DESC sau validează-l înainte. Explicația completă → JSON și Jackson
JSON parse error: Unexpected character ('}' (code 125)): was expecting double-quote to start field name JSON-ul primit nu este valid: Jackson a găsit un caracter care nu are voie să fie acolo, cel mai des o virgulă înainte de } sau ]. Corectează textul JSON (fără virgulă finală, cheile între ghilimele duble). Explicația completă → Ușor Repară tu JSON parse error: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Jackson a găsit un cuvânt care nu e o valoare JSON validă, de obicei un text fără ghilimele (Mouse în loc de "Mouse") sau un corp care nu e JSON deloc. Pune textele între ghilimele duble și trimite JSON valid. Explicația completă → Ușor Repară tu JSON parse error: Unexpected end-of-input: expected close marker for Object Textul JSON se termină înainte ca obiectul sau tabloul să fie închis: lipsește } sau ], ori corpul a fost tăiat. Verifică parantezele și dacă ai trimis tot conținutul. Explicația completă → Ușor Repară tu JSON parse error: Cannot deserialize value of type `int` from String "doi": not a valid `int` value Un câmp numeric din JSON are un text care nu e număr ("doi", "", "10 buc"). Jackson poate converti "2" în 2, dar nu și cuvinte. Trimite numărul ca număr JSON (2) sau corectează sursa datelor. Explicația completă → Ușor Repară tu JSON parse error: Cannot deserialize value of type `StatusComanda` from String "livrata": not one of the values accepted for Enum class: [NOUA, LIVRATA, ANULATA] Valoarea din JSON nu corespunde exact niciunei constante a enum-ului: implicit, Jackson cere numele scris identic, cu aceleași majuscule. Trimite "LIVRATA", activează acceptarea fără majuscule sau mapează valorile cu @JsonProperty. Explicația completă → Mediu Repară tu JSON parse error: Cannot deserialize value of type `java.time.LocalDate` from String "01.03.2026": Failed to deserialize java.time.LocalDate Data din JSON nu e în formatul ISO pe care îl așteaptă Jackson pentru LocalDate (aaaa-ll-zz, de exemplu 2026-03-01). Trimite data în format ISO sau declară formatul pe câmp cu @JsonFormat(pattern = "dd.MM.yyyy"). Explicația completă → Mediu Repară tu JSON parse error: Cannot deserialize value of type `java.util.ArrayList<ProdusNou>` from Object value (token `JsonToken.START_OBJECT`) Metoda așteaptă o listă (@RequestBody List<...>), dar clientul a trimis un singur obiect {...}. Trimite un tablou [{...}] sau schimbă parametrul să primească un singur obiect, după ce face ruta de fapt. Explicația completă → Mediu Repară tu JSON parse error: Cannot deserialize value of type `ProdusNou` from Array value (token `JsonToken.START_ARRAY`) Metoda așteaptă un singur obiect, dar clientul a trimis un tablou [...]. Dacă ruta trebuie să primească mai multe elemente, declară parametrul List<...>; altfel, clientul trebuie să trimită un singur obiect {...}. Explicația completă → Mediu Repară tu JSON parse error: Cannot deserialize value of type `java.math.BigDecimal` from String "12,50": not a valid representation Un câmp BigDecimal (sau double) a primit un text cu virgulă zecimală, cu simbol de monedă sau cu spații. JSON folosește punctul: trimite 12.50 ca număr (sau "12.50" ca text). Explicația completă → Mediu Repară tu No serializer found for class Produs and no properties discovered to create BeanSerializer (to avoid exception, disable SerializationFeature.FAIL_ON_EMPTY_BEANS) Jackson nu găsește nicio proprietate de scris în JSON pentru clasa întoarsă: câmpurile sunt private și clasa nu are getter-e publice. Adaugă getter-e (getNume()), folosește un record sau un DTO. Explicația completă → Ușor Repară tu JSON parse error: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`) În JSON-ul primit, un câmp vine ca obiect ({...}), dar în clasa Java este declarat String. Jackson nu poate pune un obiect într-un text, așa că cererea primește 400. Creează un tip pentru acel obiect (de exemplu record Adresa) sau trimite câmpul ca text. Explicația completă → Mediu Repară tu Could not write JSON: Infinite recursion (StackOverflowError) Jackson a intrat într-o buclă: entitatea Categorie are lista de produse, fiecare produs trimite înapoi la categorie și tot așa, până se umple stiva. Întoarce un DTO din controller sau oprește una dintre direcții cu @JsonIgnore (ori @JsonManagedReference / @JsonBackReference). Explicația completă → Validare
MethodArgumentNotValidException: Validation failed for argument [0] in public java.lang.String ClientController.inregistreaza(ClientNou): [Field error in object 'clientNou' on field 'email': rejected value [ana]; default message [must be a well-formed email address]] Corpul primit cu @Valid a încălcat regulile de validare (@NotBlank, @Email, @Min...), iar Spring răspunde 400. Mesajul listează câmpul, valoarea respinsă și motivul. Tratează excepția într-un @RestControllerAdvice ca clientul să primească erorile pe câmpuri. Explicația completă → Ușor Repară tu must not be blank Este mesajul implicit al lui @NotBlank: câmpul a lipsit, a fost null, gol sau doar spații. Trimite o valoare, iar dacă vrei un mesaj pentru utilizatori, scrie-l în adnotare: @NotBlank(message = "Numele este obligatoriu"). Explicația completă → Ușor Repară tu must be a well-formed email address Este mesajul implicit al lui @Email: valoarea nu arată ca o adresă de email. Atenție: @Email acceptă null și textul gol, deci pentru un email obligatoriu pune și @NotBlank. Explicația completă → Ușor Repară tu size must be between 3 and 50 Este mesajul implicit al lui @Size: lungimea textului (sau numărul de elemente al listei) e în afara intervalului. Atenție: @Size acceptă null, deci pentru un câmp obligatoriu adaugă @NotNull sau @NotBlank. Explicația completă → Mediu Repară tu HV000030: No validator could be found for constraint 'jakarta.validation.constraints.NotBlank' validating type 'java.lang.Integer'. Check configuration for 'cantitate' Ai pus o adnotare de validare pe un tip pe care nu îl suportă, de obicei @NotBlank sau @Size pe un număr. Pentru numere folosește @NotNull, @Min, @Max, @Positive; @NotBlank e doar pentru texte. Explicația completă → Ușor Repară tu package javax.validation.constraints does not exist În Spring Boot 3, adnotările de validare sunt în pachetul jakarta.validation, nu javax.validation. Înlocuiește importurile javax.validation.* cu jakarta.validation.* (și verifică dependența spring-boot-starter-validation). Explicația completă → Ușor Repară tu package jakarta.validation does not exist Proiectul nu are dependența de validare: de la Spring Boot 2.3, ea nu mai vine cu spring-boot-starter-web. Adaugă spring-boot-starter-validation în pom.xml (sau build.gradle), apoi reîncarcă proiectul. Explicația completă → Excepții și răspunsuri de eroare
Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause O excepție aruncată din controller sau serviciu nu a fost tratată nicăieri, a ajuns până la servlet, iar clientul a primit 500. Excepția reală e în paranteze și în stiva de sub mesaj. Repar-o sau trateaz-o cu un @ExceptionHandler care întoarce statusul potrivit. Explicația completă → Ușor Repară tu There was an unexpected error (type=Internal Server Error, status=500). Rândul din pagina Whitelabel spune că o excepție netratată a produs 500. Cauza e în log. Pentru excepțiile tale de business, adaugă @ResponseStatus pe clasa excepției sau un @ExceptionHandler, ca să răspunzi cu codul potrivit (404, 409). Explicația completă → Ușor Repară tu org.springframework.web.server.ResponseStatusException: 404 NOT_FOUND "Produsul 42 nu există" Este excepția prin care codul tău cere explicit un răspuns cu un anumit status (aici 404) și un motiv. Nu e un bug: Spring o transformă în răspunsul HTTP. Dacă apare unde nu te aștepți, verifică de ce lipsește resursa. Explicația completă → Ușor Repară tu java.util.NoSuchElementException: No value present Ai apelat .get() pe un Optional gol, de obicei rezultatul lui findById pentru un id inexistent, iar clientul primește 500. Folosește orElseThrow cu o excepție care dă 404, sau tratează explicit cazul gol. Explicația completă → Ușor Repară tu Cannot invoke "Produs.nume()" because the return value of "java.util.Map.get(Object)" is null Ai apelat o metodă pe rezultatul lui map.get(cheie), dar cheia nu există și get a întors null, deci NullPointerException și 500. Verifică rezultatul înainte (sau folosește getOrDefault / Optional) și răspunde 404 pentru cheile lipsă. Explicația completă → Mediu Repară tu java.lang.UnsupportedOperationException: null Ai încercat să modifici o colecție imuabilă: List.of, Map.of, Set.of, Stream.toList() sau Collections.unmodifiableList nu acceptă add/remove/put. Creează o copie modificabilă (new ArrayList<>(List.of(...))) când ai nevoie să schimbi conținutul. Explicația completă → Ușor Repară tu java.lang.IllegalArgumentException: No enum constant StatusComanda.livrata Enum.valueOf(text) a primit un text care nu este exact numele unei constante (diferă majusculele sau valoarea nu există). Normalizează textul (toUpperCase) și tratează valorile necunoscute, sau lasă Spring să convertească parametrul direct în enum. Explicația completă → Mediu Repară tu Ambiguous @ExceptionHandler method mapped for [class ProdusNegasitException] Două metode @ExceptionHandler din aceeași clasă (controller sau @ControllerAdvice) tratează exact aceeași excepție, iar Spring nu poate alege. Păstrează un singur handler pentru fiecare tip de excepție. Explicația completă → Mediu Repară tu "message": "No message available" Răspunsul de eroare implicit al Spring Boot nu conține mesajul excepției: de la Boot 2.3, message este ascuns (sau apare ca „No message available” / gol). Activează server.error.include-message=always în dezvoltare sau întoarce mesajul explicit, de exemplu cu ProblemDetail. Explicația completă → Ușor Repară tu java.lang.NumberFormatException: For input string: "doi" Codul tău a apelat Integer.parseInt (sau Long.parseLong) pe un text care nu e număr, de exemplu dintr-un antet sau dintr-o proprietate. Excepția neprinsă devine 500. Prinde NumberFormatException și răspunde 400, sau lasă Spring să convertească parametrul (@RequestHeader int). Explicația completă → Mediu Repară tu java.util.ConcurrentModificationException: null Ai modificat o listă (remove sau add) în timp ce o parcurgeai cu for-each sau cu un stream. Iteratorul observă schimbarea și aruncă excepția, iar cererea primește 500. Folosește removeIf, un Iterator cu it.remove() sau construiește o listă nouă. Explicația completă → Mediu Repară tu java.lang.IllegalStateException: Duplicate key A1 (attempted merging values 2 and 3) Collectors.toMap a primit două elemente cu aceeași cheie și nu știe pe care să-l păstreze. Dă-i al treilea argument, funcția de combinare (de exemplu (a, b) -> a + b), sau folosește groupingBy când vrei toate valorile pe cheie. Explicația completă → Spring Data JPA: entități și baza de date
Not a managed type: class Produs Spring Data a primit un repository pentru o clasă pe care JPA nu o cunoaște ca entitate. Aproape mereu lipsește @Entity pe clasa Produs sau clasa e în afara pachetelor scanate. Pune @Entity (jakarta.persistence) pe clasă și verifică pachetul. Explicația completă → Ușor Repară tu No identifier specified for entity: Produs Entitatea Produs nu are niciun câmp marcat cu @Id, iar JPA cere o cheie primară pentru fiecare entitate. Adaugă un câmp id cu @Id (de obicei Long, cu @GeneratedValue) și verifică să fie importat din jakarta.persistence. Explicația completă → Mediu Repară tu Table "PRODUSE" not found Un script SQL (de obicei data.sql) folosește o tabelă care nu există în baza de date. Fie numele e greșit (tabela entității Produs se numește produs), fie scriptul rulează înainte ca Hibernate să creeze tabelele: pune spring.jpa.defer-datasource-initialization=true. Explicația completă → Mediu Repară tu Column "PRETUNITAR" not found Instrucțiunea SQL pomenește o coloană care nu există în tabelă. În Spring Boot, cauza tipică e data.sql scris cu numele câmpului Java (pretUnitar) în loc de numele coloanei generate de Hibernate (pret_unitar). Folosește numele în snake_case sau pe cel din @Column(name). Explicația completă → Mediu Repară tu Unique index or primary key violation: "PUBLIC.UK_PRODUS_COD ON PUBLIC.PRODUS(COD)" Ai încercat să salvezi un rând cu o valoare care există deja într-o coloană unică (sau cu o cheie primară deja folosită). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException, adică 500. Verifică înainte cu existsBy... și răspunde 409, sau tratează excepția. Explicația completă → Ușor Repară tu NULL not allowed for column "NUME" Încerci să salvezi o entitate cu null într-o coloană declarată NOT NULL (de exemplu @Column(nullable = false)). Baza refuză inserarea și primești DataIntegrityViolationException, deci 500. Validează datele înainte (@NotBlank cu @Valid) sau setează valoarea lipsă. Explicația completă → Mediu Repară tu Value too long for column "NUME CHARACTER VARYING(20)" Textul salvat are mai multe caractere decât lungimea coloanei (implicit 255, sau cât ai pus în @Column(length = ...)). Baza refuză inserarea cu DataIntegrityViolationException. Validează lungimea la intrare cu @Size(max = ...) și ține aceeași limită în entitate. Explicația completă → Ușor Repară tu The given id must not be null Ai apelat findById, existsById sau deleteById cu un id null. Spring Data refuză din start și aruncă InvalidDataAccessApiUsageException (500). Verifică de unde vine id-ul: un parametru opțional, un câmp necompletat din DTO sau o entitate încă nesalvată. Explicația completă → Ușor Repară tu ids for this class must be manually assigned before calling save(): Produs Entitatea are @Id fără @GeneratedValue, deci Hibernate așteaptă ca tu să setezi id-ul. L-ai lăsat null și ai apelat save(). Adaugă @GeneratedValue pe id (dacă baza trebuie să-l genereze) sau setează id-ul înainte de salvare. Explicația completă → Mediu Repară tu No default (no-argument) constructor for class: Produs (class must be instantiated by Hibernate) Hibernate creează obiectele entității când citește rânduri din bază și are nevoie de un constructor fără argumente. Clasa ta are doar constructori cu parametri. Adaugă un constructor fără argumente (poate fi protected) lângă cel cu parametri. Explicația completă → Mediu Repară tu Error executing DDL "create table order (...)" via JDBC Hibernate a încercat să creeze o tabelă al cărei nume este cuvânt rezervat în SQL (order, user, group), iar baza a respins instrucțiunea. Dă tabelei alt nume cu @Table(name = "comenzi") sau redenumește entitatea. Explicația completă → Repository-uri, interogări și paginare
No property 'pretul' found for type 'Produs' Numele unei metode derivate (findBy...) pomenește un câmp care nu există în entitate, așa că Spring Data nu poate construi interogarea și aplicația nu pornește. Scrie după findBy numele exact al câmpului, cu prima literă mare: findByPret pentru câmpul pret. Explicația completă → Mediu Repară tu No property 'contain' found for type 'String'; Traversed path: Produs.nume Ai scris greșit un cuvânt-cheie al metodei derivate (Contain în loc de Containing, Greater în loc de GreaterThan), iar Spring Data l-a luat drept câmp al lui nume. Corectează cuvântul-cheie: findByNumeContaining, findByPretGreaterThan. Explicația completă → Ușor Repară tu Could not resolve attribute 'pretul' of 'Produs' Interogarea JPQL din @Query folosește un câmp care nu există în entitate. Hibernate validează interogările la pornire, așa că aplicația nu pornește. Scrie în JPQL numele câmpurilor Java (p.pret), nu numele coloanelor sau alte denumiri. Explicația completă → Ușor Repară tu Could not resolve root entity 'produse' În JPQL, după FROM vine numele clasei entității (Produs), nu numele tabelei (produse). Hibernate nu găsește o entitate cu numele scris și refuză interogarea la pornire. Scrie FROM Produs p, cu exact numele clasei. Explicația completă → Mediu Repară tu Using named parameters for method public abstract java.util.List ProdusRepository.cauta(java.lang.String) but parameter 'Optional[n]' not found in annotated query Numele din @Param nu corespunde cu parametrul din interogare (:nume în query, @Param("n") în metodă). Spring Data nu poate lega valoarea și aplicația nu pornește. Folosește același nume în ambele locuri: :nume și @Param("nume"). Explicația completă → Mediu Repară tu Query did not return a unique result: 2 results were returned Metoda din repository întoarce un singur obiect (Produs sau Optional<Produs>), dar interogarea a găsit mai multe rânduri. Spring aruncă IncorrectResultSizeDataAccessException (500). Întoarce List<Produs>, limitează cu findFirst, sau asigură unicitatea câmpului. Explicația completă → Ușor Repară tu Page size must not be less than one Ai creat un PageRequest cu mărimea paginii 0 sau negativă, de obicei dintr-un parametru primit de la client. PageRequest.of verifică și aruncă IllegalArgumentException (500). Validează mărimea (minim 1, plus o limită maximă) sau folosește Pageable, pe care Spring îl normalizează singur. Explicația completă → Ușor Repară tu Page index must not be less than zero Ai cerut o pagină cu index negativ: Spring Data numără paginile de la 0, iar codul a scăzut 1 dintr-o pagină 0 sau a primit o valoare negativă. PageRequest.of aruncă IllegalArgumentException (500). Verifică indexul și conversia între paginile de la 1 și cele de la 0. Explicația completă → Mediu Repară tu Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs] Ai cerut sortarea (Sort sau ?sort= în Pageable) după un câmp care nu există în entitate. Hibernate nu găsește atributul și interogarea pică cu 500. Sortează doar după câmpuri existente și, dacă sortarea vine de la client, permite doar o listă de câmpuri cunoscute. Explicația completă → Greu Repară tu No EntityManager with actual transaction available for current thread - cannot reliably process 'remove' call O metodă derivată de ștergere (deleteBy...) sau o interogare @Modifying a rulat fără tranzacție. Spring Data le cere o tranzacție activă și aruncă InvalidDataAccessApiUsageException. Pune @Transactional pe metoda din service (sau din repository) care face ștergerea. Explicația completă → Relații și tranzacții
LazyInitializationException: failed to lazily initialize a collection of role: Categorie.produse: could not initialize proxy - no Session Ai citit o relație LAZY (de obicei o colecție @OneToMany) după ce tranzacția s-a închis, de exemplu când Jackson serializează entitatea în controller. Încarcă datele de care ai nevoie în service, într-o metodă @Transactional(readOnly = true), și întoarce un DTO (sau folosește JOIN FETCH). Explicația completă → Mediu Repară tu object references an unsaved transient instance - save the transient instance before flushing: Produs.categorie -> Categorie Salvezi o entitate care trimite (printr-o relație) la alt obiect încă nesalvat, creat cu new. Hibernate nu poate scrie cheia străină pentru un rând care nu există. Salvează întâi obiectul legat (sau încarcă-l din bază), ori pune cascade pe relație dacă părintele îl deține. Explicația completă → Greu Repară tu detached entity passed to persist: Categorie Hibernate a primit pentru persist un obiect care are deja id (deci pare să existe în bază), dar nu e gestionat de sesiunea curentă. Apare des când pui cascade = ALL pe @ManyToOne și legi un obiect creat cu new și cu id setat. Încarcă obiectul din bază și scoate cascada de pe @ManyToOne. Explicația completă → Mediu Repară tu mappedBy reference an unknown target entity property: Produs.categoria in Categorie.produse Valoarea din mappedBy trebuie să fie numele câmpului care deține relația în cealaltă entitate. Ai scris un nume care nu există acolo (categoria în loc de categorie), iar Hibernate oprește pornirea. Copiază exact numele câmpului @ManyToOne din entitatea copil. Explicația completă → Greu Repară tu Transaction silently rolled back because it has been marked as rollback-only O metodă @Transactional apelată din interiorul altei tranzacții a aruncat o excepție, iar tranzacția comună a fost marcată pentru anulare. Metoda exterioară a prins excepția și a vrut să confirme, așa că Spring aruncă UnexpectedRollbackException. Nu ignora excepțiile metodelor tranzacționale interioare: întoarce un rezultat sau lasă excepția să urce. Explicația completă → Greu Repară tu A collection with cascade="all-delete-orphan" was no longer referenced by the owning entity instance: Comanda.linii Pe o colecție cu orphanRemoval = true ai înlocuit lista cu una nouă (setLinii(new ArrayList<>())). Hibernate urmărește lista originală ca să știe ce rânduri să șteargă și refuză înlocuirea. Modifică lista existentă: getLinii().clear(), apoi addAll(...). Explicația completă → Mediu Repară tu Referential integrity constraint violation: "FK_PRODUS_CATEGORIE: PUBLIC.PRODUS FOREIGN KEY(CATEGORIE_ID) REFERENCES PUBLIC.CATEGORIE(ID)" Ai încercat să ștergi un rând (o categorie) la care încă trimit alte rânduri prin cheie străină (produsele). Baza de date refuză, iar Spring aruncă DataIntegrityViolationException. Șterge sau mută întâi copiii, folosește cascade, ori răspunde 409 dacă ștergerea nu e permisă. Explicația completă → Teste cu JUnit și MockMvc
java.lang.AssertionError: Status expected:<200> but was:<404> Testul MockMvc aștepta un cod HTTP, iar endpoint-ul a răspuns cu altul. Codul primit îți spune direcția: 404 = adresă sau resursă greșită, 400 = cerere invalidă, 405 = metodă HTTP greșită, 500 = excepție în server. Verifică URL-ul și datele din test, apoi codul controllerului. Explicația completă → Ușor Repară tu org.opentest4j.AssertionFailedError: expected: <288> but was: <199> O aserțiune assertEquals din JUnit 5 a comparat valoarea așteptată (primul argument) cu cea reală (al doilea) și au ieșit diferite. Fie codul testat are un bug, fie așteptarea din test e greșită. Recalculează de mână rezultatul corect și verifică ordinea argumentelor. Explicația completă → Ușor Repară tu java.lang.AssertionError: No value at JSON path "$.denumire" jsonPath din testul MockMvc caută în răspuns un câmp care nu există: numele e greșit, structura e alta (un obiect în loc de listă) sau răspunsul nici nu e JSON. Afișează răspunsul cu andDo(print()) și scrie calea după câmpurile reale. Explicația completă → Ușor Repară tu java.lang.AssertionError: JSON path "$.pret" expected:<99> but was:<89> Câmpul din JSON există, dar are altă valoare decât cea așteptată în test. Fie datele testului diferă de ce crezi, fie codul calculează greșit, fie tipul diferă (99 față de 99.0, text față de număr). Verifică datele și tipul valorii din răspuns. Explicația completă → Ușor Repară tu org.opentest4j.AssertionFailedError: Expected java.lang.IllegalArgumentException to be thrown, but nothing was thrown. assertThrows aștepta ca lambda să arunce excepția indicată, dar codul s-a terminat normal. Fie metoda testată nu validează cazul respectiv (bug), fie testul trimite date care sunt de fapt valide. Verifică datele din test și condiția din cod. Explicația completă → Ușor Repară tu org.opentest4j.AssertionFailedError: Unexpected exception type thrown, expected: <java.lang.IllegalStateException> but was: <java.lang.IllegalArgumentException> assertThrows aștepta un tip de excepție, dar codul a aruncat altul. Decide care e tipul corect pentru acea situație: dacă testul are dreptate, schimbă excepția din cod; dacă codul are dreptate, corectează testul. Explicația completă → Ușor Repară tu java.lang.AssertionError: Range for response status value 200 expected:<CLIENT_ERROR> but was:<SUCCESSFUL> Ai verificat o familie de coduri (is4xxClientError, is2xxSuccessful, is5xxServerError), iar răspunsul a avut un cod din altă familie. Aici aștepta o eroare 4xx, dar cererea a reușit (200). Verifică dacă cererea din test e cu adevărat invalidă și dacă endpoint-ul validează. Explicația completă → Ușor Repară tu java.lang.AssertionError: Response content expected:<Salut, Ana> but was:<Salut, Ana!> content().string(...) compară tot corpul răspunsului, caracter cu caracter, iar textul primit diferă de cel așteptat (un semn de punctuație, un spațiu, diacritice, ghilimele JSON). Copiază textul exact din răspuns sau verifică doar partea care contează cu containsString. Explicația completă → Ușor Repară tu org.junit.platform.commons.JUnitException: @BeforeAll method 'void CosServiceTest.pregateste()' must be static unless the test class is annotated with @TestInstance(Lifecycle.PER_CLASS). JUnit 5 rulează metodele @BeforeAll o singură dată, înainte să creeze vreo instanță a clasei de test, deci ele trebuie să fie static. Fă metoda static (și câmpurile pe care le setează), sau pune @TestInstance(Lifecycle.PER_CLASS) pe clasă. Explicația completă → Mediu Repară tu org.junit.jupiter.api.extension.ParameterResolutionException: No ParameterResolver registered for parameter [int procent] in method [void CosServiceTest.reducereValida(int)]. O metodă @Test are parametri, dar JUnit nu știe de unde să-i ia valorile. Dacă vrei același test cu mai multe valori, folosește @ParameterizedTest cu o sursă (@ValueSource, @CsvSource) în loc de @Test. Explicația completă → Mediu Repară tu java.lang.IllegalStateException: Found multiple @SpringBootConfiguration annotated classes [Generic bean: class [Application], Generic bean: class [AdminApp]] Testul @SpringBootTest caută clasa de configurare urcând prin pachete și a găsit mai multe clase @SpringBootApplication, deci nu știe pe care s-o pornească. Indică explicit aplicația: @SpringBootTest(classes = Application.class), sau păstrează o singură clasă principală per modul. Explicația completă → Mediu Repară tu java.lang.IllegalStateException: Failed to load ApplicationContext for [WebMergedContextConfiguration@1b2c3d4e testClass = ProdusControllerTest] Testul @SpringBootTest nu a putut porni contextul aplicației, deci toate testele clasei pică. Mesajul e doar ambalajul: cauza reală e mai jos, la ultimul „Caused by” (un bean lipsă, o proprietate nerezolvată, o eroare de JPA). Repar-o ca pe o eroare de pornire a aplicației. Explicația completă → Ușor Repară tu No qualifying bean of type 'org.springframework.test.web.servlet.MockMvc' available: expected at least 1 bean which qualifies as autowire candidate Ai injectat MockMvc într-un test @SpringBootTest, dar MockMvc nu se creează automat acolo. Adaugă @AutoConfigureMockMvc pe clasa de test (sau folosește @WebMvcTest, care îl configurează singur). Explicația completă → Mediu Repară tu jakarta.servlet.ServletException: Request processing failed: java.lang.IllegalStateException: Produsul 99 nu există În testul MockMvc, controllerul a aruncat o excepție pe care nimic nu a transformat-o într-un răspuns HTTP, iar MockMvc o aruncă mai departe, împachetată în ServletException. Tratează excepția în aplicație (@ResponseStatus, ResponseStatusException sau @ExceptionHandler), ca testul să primească un cod HTTP. Explicația completă → Mediu Repară tu No tests found for given includes: [CosServiceTest](--tests filter) Runner-ul JUnit 5 nu a găsit niciun test, de obicei pentru că ai importat org.junit.Test (JUnit 4) în loc de org.junit.jupiter.api.Test. Platforma JUnit 5 ignoră adnotarea veche. Schimbă importul (și aserțiunile) pe pachetul org.junit.jupiter.api. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expecting ArrayList: ["Mouse", "Tastatură"] to contain: ["Monitor"] but could not find the following element(s): ["Monitor"] O aserțiune AssertJ contains(...) a căutat în colecție un element care nu există acolo. Fie datele testului nu conțin elementul, fie codul nu-l adaugă, fie equals nu se potrivește (compari obiecte fără equals sau texte cu altă formă). Mesajul arată colecția reală: compar-o cu ce aștepți. Explicația completă → Ușor Repară tu org.opentest4j.AssertionFailedError: expected: <true> but was: <false> assertTrue a primit o condiție falsă. Mesajul nu spune ce condiție, așa că adaugă un mesaj ca al doilea argument sau folosește o aserțiune mai precisă (assertEquals, assertThat(x).isGreaterThan(y)). Apoi verifică dacă greșește condiția din test sau codul testat. Explicația completă → Ușor Repară tu org.opentest4j.AssertionFailedError: expected: not <null> O aserțiune assertNotNull din JUnit 5 a primit null. Codul testat nu a găsit sau nu a creat obiectul pe care îl așteptai. Verifică de ce metoda întoarce null (o cheie greșită, o căutare care nu găsește nimic, un câmp necompletat) și repară codul, nu testul. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expecting actual not to be null O aserțiune AssertJ assertThat(x).isNotNull() (sau orice aserțiune pe un obiect null) a primit null. Valoarea testată nu a fost completată: o mapare care uită un câmp, o căutare care nu găsește nimic sau o dependență neinjectată. Găsește de unde vine null și repară codul. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expected size: 3 but was: 2 in: [...] Aserțiunea AssertJ hasSize(3) a primit o colecție cu alt număr de elemente (aici 2). Mesajul arată și conținutul real al colecției. Compară elementele afișate cu cele așteptate: de obicei un filtru greșit (> în loc de >=) sau date de test lipsă. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expecting actual not to be empty Aserțiunea AssertJ isNotEmpty() a primit o listă (sau un text, un Optional) goală. Codul testat nu a găsit nimic: o interogare care ține cont de literele mari, un filtru prea strict sau date de test lipsă. Verifică interogarea și datele, nu șterge aserțiunea. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expecting actual: 0 to be greater than: 0 Aserțiunea AssertJ isGreaterThan(x) a primit o valoare mai mică sau egală cu x. În calcule cu int, cauza tipică este împărțirea întreagă (15 / 100 dă 0). Verifică formula codului testat și ordinea operațiilor. Explicația completă → Mediu Repară tu java.lang.AssertionError: JSON path "$" Expected: a collection with size <3> but: collection size was <2> Într-un test MockMvc, jsonPath("$", hasSize(3)) a găsit în răspunsul JSON o listă cu alt număr de elemente. Fie endpoint-ul întoarce prea multe sau prea puține elemente (filtru, paginare, limită greșită), fie expresia JSON path arată spre altă listă. Explicația completă → Ușor Repară tu java.lang.AssertionError: Expecting message to be: "Stoc insuficient pentru A1" but was: "Stoc insuficient" Testul AssertJ assertThatThrownBy(...).hasMessage("...") a prins excepția corectă, dar textul ei e altul decât cel așteptat. Compară cele două mesaje din eroare și decide dacă greșește codul (mesajul excepției) sau testul. Explicația completă → Securitate, filtre și CORS
Full authentication is required to access this resource Spring Security a respins cererea cu 401 Unauthorized pentru că nu a găsit un utilizator autentificat: lipsește antetul Authorization, tokenul e invalid sau expirat, ori e trimis în alt format decât așteaptă serverul (de exemplu fără prefixul Bearer). Verifică antetul trimis și felul în care filtrul îl citește. Explicația completă → Mediu Repară tu Access Denied Utilizatorul e autentificat, dar regula de autorizare l-a respins (AccessDeniedException, 403 Forbidden). Cauze frecvente: rolul nu corespunde (hasRole("ADMIN") caută ROLE_ADMIN), utilizatorul chiar nu are rolul, sau CSRF a blocat un POST. Verifică rolurile din token și regula exactă. Explicația completă → Ușor Repară tu Using generated security password: 8e557245-73e2-4286-969a-ff57fe326336 Nu e o eroare, ci un avertisment: ai adăugat spring-boot-starter-security fără configurare proprie, așa că Spring Boot a creat un utilizator implicit (user) cu o parolă aleatoare și a protejat toate rutele. Definește un SecurityFilterChain care spune ce rute sunt publice și cum se autentifică restul. Explicația completă → Mediu Repară tu There is no PasswordEncoder mapped for the id "null" Parola salvată nu are prefixul {id} (de exemplu {bcrypt}) pe care DelegatingPasswordEncoder îl folosește ca să aleagă algoritmul, de obicei pentru că parola e în clar. Salvează parolele codificate cu PasswordEncoder.encode(...) sau folosește explicit un BCryptPasswordEncoder. Explicația completă → Mediu Repară tu Invalid CSRF token found for http://localhost:8080/api/comenzi Protecția CSRF a lui Spring Security a respins o cerere care modifică date (POST, PUT, DELETE) pentru că nu avea tokenul CSRF. De aceea GET merge, iar POST dă 403. Pentru un API REST stateless, autentificat cu token în antet, dezactivează CSRF; pentru aplicații cu sesiune și cookie, trimite tokenul. Explicația completă → Mediu Repară tu Access to fetch at 'http://localhost:8080/api/produse' from origin 'http://localhost:3000' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. Browserul a blocat răspunsul pentru că frontend-ul (localhost:3000) și API-ul (localhost:8080) au origini diferite, iar serverul nu a trimis antetul Access-Control-Allow-Origin. Configurează CORS în Spring: addCorsMappings sau @CrossOrigin, cu originea exactă a frontend-ului. Explicația completă → Mediu Repară tu When allowCredentials is true, allowedOrigins cannot contain the special value "*" since that cannot be set on the "Access-Control-Allow-Origin" response header. Ai configurat CORS cu allowCredentials(true) și allowedOrigins("*"), combinație interzisă de specificația CORS: cu cookie-uri sau autentificare, serverul trebuie să numească originea exactă. Listează originile concrete sau folosește allowedOriginPatterns. Explicația completă → Ușor Repară tu Invalid CORS request Serverul are CORS configurat, dar originea din care vine cererea nu e în lista permisă, așa că Spring răspunde 403 cu textul Invalid CORS request. Adaugă originea exactă a frontend-ului (schemă, domeniu și port) în allowedOrigins. Explicația completă → Apeluri între servicii și Spring Cloud
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ă. Explicația completă → Mediu Repară tu 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. Explicația completă → Mediu Repară tu HttpServerErrorException$InternalServerError: 500 Internal Server Error: "{"status":500,"error":"Internal Server Error","path":"/stoc/A1"}" Serviciul apelat a răspuns cu o eroare 5xx, iar RestClient/RestTemplate aruncă HttpServerErrorException. Problema e în celălalt serviciu, dar neprinsă îți strică și răspunsul tău (500). Prinde excepția, răspunde cu 503 sau cu o valoare de rezervă, și investighează jurnalul serviciului apelat. Explicația completă → Mediu Repară tu I/O error on GET request for "http://localhost:8081/stoc/A1": Read timed out Conexiunea la serviciul apelat s-a deschis, dar răspunsul n-a venit în timpul de citire configurat (read timeout). Serviciul e lent sau blocat. Pune un timeout rezonabil și tratează depășirea lui: răspunde 503, folosește o valoare de rezervă sau un circuit breaker. Explicația completă → Mediu Repară tu 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. Explicația completă → Mediu Repară tu 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. Explicația completă → Ușor Repară tu 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. Explicația completă → Mediu Repară tu 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. Explicația completă → Mediu Repară tu CallNotPermittedException: CircuitBreaker 'stoc' is OPEN and does not permit further calls Circuit breaker-ul Resilience4j a văzut prea multe apeluri eșuate către serviciu și s-a deschis: blochează apelurile pentru o perioadă și aruncă CallNotPermittedException. Este comportamentul dorit. Ce lipsește de obicei e o metodă fallback care să răspundă cât timp circuitul e deschis. Explicația completă → Mediu Repară tu 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. Explicația completă → Mediu Repară tu Unable to find GatewayFilterFactory with name StripPrefixx O rută din Spring Cloud Gateway folosește un filtru al cărui nume nu există: o greșeală de scriere (StripPrefixx), un filtru dintr-o dependență lipsă sau un filtru propriu înregistrat cu alt nume. Gateway-ul nu poate construi ruta. Corectează numele din filters. Explicația completă → Ușor Repară tu Parameter 0 of constructor in ProdusController required a bean of type 'StocClient' that could not be found Ai declarat o interfață @FeignClient, dar Spring nu a creat implementarea ei, deci nu are ce injecta. Aproape mereu lipsește @EnableFeignClients pe clasa principală, sau interfața e într-un pachet pe care scanarea Feign nu-l acoperă. Adaugă adnotarea (cu basePackages, dacă e nevoie). Explicația completă → Mediu Repară tu HttpClientErrorException$Unauthorized: 401 Unauthorized: "{"status":401,"error":"Unauthorized","path":"/stoc/A1/rezervat"}" Serviciul apelat cere autentificare, iar cererea clientului tău nu avea credențiale valide (antet Authorization lipsă, token expirat sau greșit). RestClient transformă 401 în HttpClientErrorException$Unauthorized. Trimite antetul cerut, de preferat configurat o singură dată pe client. Explicația completă → Proiect, dependențe și migrarea la Boot 3
error: package javax.persistence does not exist Proiectul folosește Spring Boot 3 (Jakarta EE), unde adnotările JPA s-au mutat din javax.persistence în jakarta.persistence. Schimbă importurile din javax.persistence.* în jakarta.persistence.*; restul codului rămâne la fel. Explicația completă → Ușor Repară tu error: package javax.servlet.http does not exist În Spring Boot 3, API-ul Servlet este în jakarta.servlet, nu în javax.servlet. Înlocuiește importurile (HttpServletRequest, HttpServletResponse, Filter, Cookie) cu jakarta.servlet.*. Explicația completă → Ușor Repară tu Cannot resolve symbol 'SpringBootApplication' Compilatorul nu găsește adnotarea @SpringBootApplication: lipsește importul org.springframework.boot.autoconfigure.SpringBootApplication sau proiectul nu are dependențele Spring Boot (Maven/Gradle nu le-a descărcat). Adaugă importul și reîncarcă proiectul. Explicația completă → Mediu Repară tu ApplicationContextException: Unable to start web server; nested exception is ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean. Spring Boot nu poate porni serverul web pentru că lipsește configurarea automată: clasa dată lui SpringApplication.run nu are @SpringBootApplication (sau @EnableAutoConfiguration), ori lipsește spring-boot-starter-web. Pune adnotarea pe clasa principală. Explicația completă → Mediu Repară tu GET /actuator/info → 404 No static resource actuator/info. Endpoint-ul Actuator există, dar nu este expus prin HTTP: implicit, Spring Boot expune doar /actuator/health. Adaugă endpoint-ul în management.endpoints.web.exposure.include (și, pentru /info, activează sursa de date, de exemplu management.info.env.enabled=true). Explicația completă → Mediu Repară tu GET /actuator/health → 503 {"status":"DOWN"} Cel puțin un HealthIndicator (bază de date, disc, un serviciu extern sau unul scris de tine) raportează DOWN, deci starea totală e DOWN, iar răspunsul are codul 503. Activează show-details ca să vezi componenta problematică, apoi repar-o (de obicei configurarea). Explicația completă → Ușor Repară tu GET /actuator/info → {} Endpoint-ul /actuator/info e expus, dar răspunde un obiect gol, deși ai proprietăți info.* în application.properties. Din Spring Boot 2.6 contribuția din proprietăți e dezactivată implicit: pune management.info.env.enabled=true (sau adaugă build-info / git-info). Explicația completă → Nicio eroare nu se potrivește căutării. Încearcă doar partea fixă a mesajului (fără numele variabilelor).
Erori explicate la alte tehnologii
Î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.
