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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Începând cu Spring Framework 6.1 (Spring Boot 3.2), cererile care nu se potrivesc cu nicio metodă de controller sunt preluate de handler-ul pentru resurse statice (static/, public/). Când nici acolo nu există un fișier cu acea cale, se aruncă NoResourceFoundException: No static resource api/produse., iar clientul primește 404. În log apare ca WARN ... Resolved [org.springframework.web.servlet.resource.NoResourceFoundException: No static resource api/produse.].
Mesajul te poate deruta („dar eu nu cer un fișier static!”): de fapt spune că nicio rută nu a acceptat cererea. Calea din mesaj e cea primită, fără / la început.
Cauze tipice: prefixul de pe clasă lipsește sau e diferit, clasa nu are @RestController (deci nu e controller), calea are / la final (din Boot 3 /produse/ nu mai e echivalent cu /produse) sau o greșeală de scriere.
De ce apare: cauzele frecvente
1Lipsește prefixul de pe clasă
@RestController
class ProdusController {
@GetMapping("/produse") ... // cererea: /api/produse
}@RestController
@RequestMapping("/api")
class ProdusController {
@GetMapping("/produse") ...
}Calea finală este prefixul clasei plus calea metodei.
2Clasa nu e controller
class ProdusController {
@GetMapping("/api/produse") ...
}@RestController
class ProdusController {
@GetMapping("/api/produse") ...
}Fără @RestController, metodele nu sunt înregistrate ca rute.
3Slash la final (Boot 3)
GET /api/produse/ // ruta: /api/produseGET /api/produseDin Spring 6, potrivirea cu / final e dezactivată implicit: sunt două căi diferite.
Repară eroarea, direct în pagină
GET /api/produse răspunde 404 cu No static resource api/produse.. Controller-ul are rutele scrise fără prefixul /api. Adaugă prefixul o singură dată, pe clasă, ca GET /api/produse și GET /api/produse/1 să funcționeze.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final List<String> produse = List.of("Mouse", "Tastatură");
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@GetMapping("/produse/{index}")
String unul(@PathVariable int index) {
return produse.get(index);
}
}Tomcat started on port 8080 (http) Started Application GET /api/produse → 200 ["Mouse","Tastatură"] GET /api/produse/1 → 200 Tastatură
Indiciu
@RequestMapping pe clasă adaugă un prefix tuturor metodelor.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
@RequestMapping("/api")
class ProdusController {
private final List<String> produse = List.of("Mouse", "Tastatură");
@GetMapping("/produse")
List<String> toate() {
return produse;
}
@GetMapping("/produse/{index}")
String unul(@PathVariable int index) {
return produse.get(index);
}
}De ce merge
Nicio metodă nu era mapată pe /api/produse, așa că cererea a ajuns la handler-ul de fișiere statice, care a răspuns 404 cu No static resource. @RequestMapping("/api") pe clasă se adaugă în fața fiecărei metode: rutele devin /api/produse și /api/produse/{index}. Avantajul: dacă prefixul se schimbă (de exemplu /api/v2), îl modifici într-un singur loc.
Alte forme ale mesajului
org.springframework.web.servlet.resource.NoResourceFoundException: No static resource favicon.ico.No endpoint GET /api/produse.
Cum o eviți pe viitor
- Definește prefixul API-ului o dată, pe clasă, cu
@RequestMapping("/api/..."). - Folosește în client aceleași căi ca în cod, fără
/la final. - La pornire cu
logging.level.org.springframework.web=DEBUGvezi toate rutele mapate. - Scrie un test MockMvc pentru fiecare rută nouă.
Întrebări frecvente
De ce în Spring Boot 3.1 primeam alt mesaj?
Înainte de 3.2, cererile fără rută dădeau tot 404, dar fără NoResourceFoundException în log. Comportamentul pentru client e același.
Ce e cu No static resource favicon.ico în log?
Browserul cere automat iconița site-ului. Dacă nu ai favicon.ico în static/, apare acest 404, care e inofensiv.
Erori înrudite
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. 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ă. 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"). Î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.
