...
Eroare Spring Boot · Repository-uri, interogări și paginare

Using named parameters for method public abstract java.util.List ProdusRepository.cauta(java.lang.String) but parameter 'Optional[n]' not found in annotated query

Pe scurt

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

Greșit
JAVA
@Query("SELECT p FROM Produs p WHERE p.nume = :nume")
List<Produs> cauta(@Param("n") String nume);
Corect
JAVA
@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

Greșit
JAVA
@Query("... WHERE p.pret BETWEEN :minim AND :maxim")
List<Produs> intre(@Param("min") int min, @Param("max") int max);
Corect
JAVA
@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

Greșit
JAVA
import org.apache.ibatis.annotations.Param;
Corect
JAVA
import org.springframework.data.repository.query.Param;

Spring Data recunoaște doar @Param din pachetul lui.

Repară tu

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.

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

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 -parameters
  • Could 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 @Param pe 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

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