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

Query did not return a unique result: 2 results were returned

Pe scurt

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

Greșit
JAVA
Optional<Produs> findByCategorie(String categorie);
Corect
JAVA
List<Produs> findByCategorie(String categorie);

O categorie are mai multe produse; tipul de retur trebuie să o spună.

2Vrei doar primul rezultat

Greșit
JAVA
Optional<Comanda> findByClient(String client);
Corect
JAVA
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

Greșit
JAVA
@Column
private String email;
Corect
JAVA
@Column(unique = true)
private String email;

Constrângerea împiedică duplicatele care ar strica findByEmail.

Repară tu

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.

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

Alte forme ale mesajului

  • org.springframework.dao.IncorrectResultSizeDataAccessException: Query did not return a unique result: 2 results were returned
  • jakarta.persistence.NonUniqueResultException: Query did not return a unique result: 2 results were returned
  • query did not return a unique result: 2

Cum o eviți pe viitor

  • Alege tipul de retur după date: Optional doar pentru câmpuri unice, List în rest.
  • Pune unique = true pe 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

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