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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o interogare @Query cu parametri numiți (:nume, :min), fiecare parametru trebuie legat de un argument al metodei. Legătura se face prin @Param("nume") sau, dacă proiectul compilează cu -parameters (ca proiectele Spring Boot cu Maven sau Gradle), prin numele argumentului.
Când metoda declară un nume care nu apare în interogare, Spring Data se oprește la pornire: Using named parameters for method ... but parameter 'Optional[n]' not found in annotated query 'SELECT p FROM Produs p WHERE p.nume = :nume'!. Optional[n] este felul în care Spring afișează numele găsit pe argument (n), iar textul interogării îți arată numele așteptat (:nume).
Situația înrudită For queries with named parameters you need to provide names for method parameters apare când argumentul nu are nici @Param, nici nume disponibil la rulare (compilare fără -parameters): soluția e tot @Param.
De ce apare: cauzele frecvente
1@Param cu alt nume decât în interogare
@Query("SELECT p FROM Produs p WHERE p.nume = :nume")
List<Produs> cauta(@Param("n") String nume);@Query("SELECT p FROM Produs p WHERE p.nume = :nume")
List<Produs> cauta(@Param("nume") String nume);Valoarea din @Param trebuie să fie exact numele de după :.
2Ai redenumit parametrul doar în interogare
@Query("... WHERE p.pret BETWEEN :minim AND :maxim")
List<Produs> intre(@Param("min") int min, @Param("max") int max);@Query("... WHERE p.pret BETWEEN :min AND :max")
List<Produs> intre(@Param("min") int min, @Param("max") int max);Redenumirile trebuie făcute în ambele locuri.
3Ai importat @Param din pachetul greșit
import org.apache.ibatis.annotations.Param;import org.springframework.data.repository.query.Param;Spring Data recunoaște doar @Param din pachetul lui.
Repară eroarea, direct în pagină
Aplicația nu pornește: parametrul din @Param nu se potrivește cu cel din interogare. Repară legătura ca GET /produse/cauta?nume=Mouse să întoarcă produsul cu acest nume. Interogarea JPQL este corectă: problema e doar la legarea parametrului.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.repository.query.Param;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
private String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
@Query("SELECT p FROM Produs p WHERE p.nume = :nume")
List<Produs> cauta(@Param("n") String nume);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/cauta")
List<Produs> cauta(@RequestParam String nume) {
return repo.cauta(nume);
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse/cauta?nume=Mouse → 200
[{"id":1,"nume":"Mouse","categorie":"periferice","pret":89}]Indiciu
Compară numele de după două puncte din interogare cu valoarea din @Param.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
import org.springframework.data.repository.query.Param;
import org.springframework.web.bind.annotation.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
private Long id;
private String nume;
private String categorie;
private int pret;
protected Produs() {
}
public Long getId() { return id; }
public String getNume() { return nume; }
public String getCategorie() { return categorie; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> {
@Query("SELECT p FROM Produs p WHERE p.nume = :nume")
List<Produs> cauta(@Param("nume") String nume);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/cauta")
List<Produs> cauta(@RequestParam String nume) {
return repo.cauta(nume);
}
}De ce merge
Interogarea are parametrul :nume, deci argumentul metodei trebuie anunțat ca @Param("nume"). Cu @Param("n"), Spring Data găsea pe argument un nume care nu apare în interogare și oprea pornirea. Numele variabilei Java poate fi oricare; contează valoarea din @Param, care trebuie să fie identică cu numele din interogare.
Alte forme ale mesajului
For queries with named parameters you need to provide names for method parameters; Use @Param for query method parameters, or when on Java 8+ use the javac flag -parametersCould not locate named parameter [nume], expecting one of [n]
Cum o eviți pe viitor
- Folosește aceleași nume peste tot:
:numeși@Param("nume") String nume. - Pune
@Parampe toți parametrii interogărilor@Query, chiar dacă proiectul compilează cu-parameters: codul rămâne corect și în alte configurări. - Importă
org.springframework.data.repository.query.Param. - Pornește aplicația după fiecare interogare nouă.
Întrebări frecvente
Pot folosi parametri poziționali?
Da: WHERE p.nume = ?1 leagă primul argument, fără @Param. Sunt mai fragili când adaugi parametri, de aceea parametrii numiți sunt preferați.
De ce merge la un coleg fără @Param?
Proiectul lui compilează cu flag-ul -parameters (implicit în pluginul Spring Boot), deci numele argumentelor există la rulare. Într-un IDE configurat altfel, aceeași metodă pică.
Erori înrudite
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. 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. Î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.
