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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când tipul de retur al unei metode derivate sau @Query este o entitate sau Optional<Entitate>, Spring Data se așteaptă la cel mult un rând. Dacă baza întoarce două sau mai multe, nu poate alege singur, așa că aruncă IncorrectResultSizeDataAccessException: Query did not return a unique result: 2 results were returned (în spate e NonUniqueResultException din Hibernate).
Eroarea apare la rulare, abia când datele conțin duplicate: în teste, cu un singur rând, totul merge, iar în producție, după ce cineva adaugă al doilea produs cu același nume, endpoint-ul dă 500.
Întrebarea de pus este: câmpul după care caut e unic prin definiție? Dacă da (email, cod), pune constrângerea unique și metoda e corectă. Dacă nu (nume, oraș, categorie), întoarce o listă sau alege explicit unul, de exemplu cel mai recent.
De ce apare: cauzele frecvente
1Cauți după un câmp care nu e unic
Optional<Produs> findByCategorie(String categorie);List<Produs> findByCategorie(String categorie);O categorie are mai multe produse; tipul de retur trebuie să o spună.
2Vrei doar primul rezultat
Optional<Comanda> findByClient(String client);Optional<Comanda> findFirstByClientOrderByIdDesc(String client);First/Top adaugă limita, iar OrderBy alege care e „primul”.
3Câmpul ar trebui să fie unic, dar baza permite duplicate
@Column
private String email;@Column(unique = true)
private String email;Constrângerea împiedică duplicatele care ar strica findByEmail.
Repară eroarea, direct în pagină
GET /produse/categorie/periferice dă 500 cu Query did not return a unique result, pentru că o categorie are mai multe produse. Schimbă metoda din repository și ruta ca să întoarcă lista tuturor produselor din categorie.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.*;
import jakarta.persistence.*;
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> {
Optional<Produs> findByCategorie(String categorie);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/categorie/{cat}")
Optional<Produs> dinCategorie(@PathVariable String cat) {
return repo.findByCategorie(cat);
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse/categorie/periferice → 200
[{"id":1,"nume":"Mouse","categorie":"periferice","pret":89},{"id":2,"nume":"Tastatură","categorie":"periferice","pret":199},{"id":4,"nume":"Webcam","categorie":"periferice","pret":249}]
GET /produse/categorie/ecrane → 200
[{"id":3,"nume":"Monitor","categorie":"ecrane","pret":799}]Indiciu
Tipul de retur al metodei trebuie să permită mai multe rezultate.
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.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> {
List<Produs> findByCategorie(String categorie);
}
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
@GetMapping("/produse/categorie/{cat}")
List<Produs> dinCategorie(@PathVariable String cat) {
return repo.findByCategorie(cat);
}
}De ce merge
Optional<Produs> îi promitea lui Spring Data cel mult un rezultat, iar categoria „periferice” are trei produse, deci interogarea pica. Cu List<Produs>, metoda întoarce toate rândurile găsite; pentru „ecrane” lista are un singur element. Categoria nu e un câmp unic, deci lista e tipul corect.
Alte forme ale mesajului
org.springframework.dao.IncorrectResultSizeDataAccessException: Query did not return a unique result: 2 results were returnedjakarta.persistence.NonUniqueResultException: Query did not return a unique result: 2 results were returnedquery did not return a unique result: 2
Cum o eviți pe viitor
- Alege tipul de retur după date:
Optionaldoar pentru câmpuri unice,Listîn rest. - Pune
unique = truepe câmpurile pe care le cauți ca identificatori. - Folosește
findFirstBy...OrderBy...când vrei explicit un singur rezultat. - Testează metodele cu date care conțin duplicate.
Întrebări frecvente
De ce nu primesc pur și simplu primul rând?
Pentru că Spring nu știe care e „primul” fără o ordine. Ar fi o alegere aleatoare; de aceea îți cere să decizi tu, cu First și OrderBy.
Ce cod HTTP dau clientului?
Eroarea e de programare sau de date, nu a clientului. Repară metoda; nu o ascunde transformând-o în 400.
Erori înrudite
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. 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. Î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.
