...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

No static resource api/produse.

Pe scurt

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

Greșit
JAVA
@RestController
class ProdusController {
    @GetMapping("/produse") ...   // cererea: /api/produse
}
Corect
JAVA
@RestController
@RequestMapping("/api")
class ProdusController {
    @GetMapping("/produse") ...
}

Calea finală este prefixul clasei plus calea metodei.

2Clasa nu e controller

Greșit
JAVA
class ProdusController {
    @GetMapping("/api/produse") ...
}
Corect
JAVA
@RestController
class ProdusController {
    @GetMapping("/api/produse") ...
}

Fără @RestController, metodele nu sunt înregistrate ca rute.

3Slash la final (Boot 3)

Greșit
JAVA
GET /api/produse/   // ruta: /api/produse
Corect
JAVA
GET /api/produse

Din Spring 6, potrivirea cu / final e dezactivată implicit: sunt două căi diferite.

Repară tu

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.

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

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=DEBUG vezi 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

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