System.InvalidOperationException: Sequence contains more than one element
Single sau SingleOrDefault au găsit mai multe rânduri, deși promit cel mult unul. Dacă pot exista mai multe, întoarce o listă (ToListAsync) sau alege explicit primul cu OrderBy + FirstOrDefault; dacă trebuie să fie unic, pune un index unic în bază.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Single() și SingleOrDefault() au un contract mai strict decât First(): verifică faptul că rezultatul conține exact un element (respectiv cel mult unul). Ca să știe asta, EF Core cere de fapt două rânduri (TOP(2) / LIMIT 2); dacă primește două, aruncă această excepție.
Atenție la confuzia frecventă: SingleOrDefault nu te protejează de duplicate. „OrDefault” se referă doar la cazul cu zero rezultate (întoarce null), nu și la cel cu mai multe.
Excepția îți spune, de fapt, că o presupunere despre date e falsă: ai crezut că un oraș, un email sau un cod identifică un singur rând, dar în tabel sunt mai multe. Ai două variante: fie presupunerea e greșită (mai mulți clienți din același oraș e normal, deci întorci o listă), fie datele sunt corupte (două conturi cu același email) și ai nevoie de un index unic care să împiedice duplicatele.
De ce apare: cauzele frecvente
1Filtru care nu e unic
var client = await db.Clienti.Where(c => c.Oras == oras).SingleAsync();var clienti = await db.Clienti.Where(c => c.Oras == oras).ToListAsync();Orașul nu identifică un client; rezultatul firesc e o listă.
2Vrei doar unul, oricare
var ultima = db.Comenzi.SingleOrDefault(c => c.ClientId == id);var ultima = db.Comenzi.Where(c => c.ClientId == id)
.OrderByDescending(c => c.Data)
.FirstOrDefault();Cu OrderBy + FirstOrDefault alegi explicit care element te interesează.
3Valoarea trebuie să fie unică, dar baza permite duplicate
var u = db.Utilizatori.SingleOrDefault(u => u.Email == email);m.Entity<Utilizator>().HasIndex(u => u.Email).IsUnique();
// apoi Single are sens: baza garantează unicitateaDacă regula de business e „un cont per email”, impune-o în bază; altfel duplicatele vor apărea la un moment dat.
Repară eroarea, direct în pagină
GET /clienti?oras=Cluj răspunde 500 cu Sequence contains more than one element, pentru că în Cluj sunt doi clienți. Endpoint-ul trebuie să întoarcă lista tuturor clienților din orașul cerut, ordonați după id.
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseInMemoryDatabase("clienti"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<AppDb>();
db.Clienti.AddRange(
new Client { Nume = "Ana Pop", Oras = "Cluj" },
new Client { Nume = "Ion Ionescu", Oras = "Iași" },
new Client { Nume = "Maria Pop", Oras = "Cluj" });
db.SaveChanges();
}
app.MapGet("/clienti", async (string oras, AppDb db) =>
{
var client = await db.Clienti.Where(c => c.Oras == oras).SingleAsync();
return Results.Ok(client);
});
app.Run();
public class Client
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public string Oras { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Client> Clienti => Set<Client>();
}GET /clienti?oras=Cluj → 200 OK
[{"id":1,"nume":"Ana Pop","oras":"Cluj"},{"id":3,"nume":"Maria Pop","oras":"Cluj"}]
GET /clienti?oras=Iași → 200 OK
[{"id":2,"nume":"Ion Ionescu","oras":"Iași"}]Indiciu
Un oraș poate avea mai mulți clienți, deci rezultatul e o listă.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<AppDb>(o => o.UseInMemoryDatabase("clienti"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<AppDb>();
db.Clienti.AddRange(
new Client { Nume = "Ana Pop", Oras = "Cluj" },
new Client { Nume = "Ion Ionescu", Oras = "Iași" },
new Client { Nume = "Maria Pop", Oras = "Cluj" });
db.SaveChanges();
}
app.MapGet("/clienti", async (string oras, AppDb db) =>
{
var clienti = await db.Clienti.Where(c => c.Oras == oras).OrderBy(c => c.Id).ToListAsync();
return Results.Ok(clienti);
});
app.Run();
public class Client
{
public int Id { get; set; }
public string Nume { get; set; } = "";
public string Oras { get; set; } = "";
}
public class AppDb(DbContextOptions<AppDb> options) : DbContext(options)
{
public DbSet<Client> Clienti => Set<Client>();
}De ce merge
SingleAsync verifica faptul că există exact un client în orașul cerut; Cluj are doi, deci excepție și 500. Presupunerea era greșită, nu datele: rezultatul corect e o listă. ToListAsync întoarce toți clienții, iar OrderBy(c => c.Id) face ordinea previzibilă. Pentru Iași lista are un singur element.
Alte forme ale mesajului
System.InvalidOperationException: Sequence contains more than one matching element
Cum o eviți pe viitor
- Folosește
Single/SingleOrDefaultdoar pe chei primare sau pe coloane cu index unic. - Pentru filtre care pot întoarce mai multe rânduri, întoarce liste sau ordonează și ia primul.
- Pune indexuri unice pentru regulile de unicitate; nu te baza pe „n-ar trebui să existe duplicate”.
Întrebări frecvente
E Single mai lent decât First?
Puțin: EF cere două rânduri în loc de unul ca să poată verifica unicitatea. Diferența contează rar; important e că alegi metoda după contractul pe care vrei să-l verifici.
De ce a mers până ieri?
Pentru că până ieri exista un singur rând care se potrivea. Excepția apare din momentul în care datele încalcă presupunerea, de exemplu după ce s-a înregistrat al doilea client din același oraș.
Erori înrudite
System.InvalidOperationException: Sequence contains no elements First, Single, Last, Min, Max sau Average au rulat pe o interogare fără niciun rezultat. Pentru căutări care pot să nu găsească nimic folosește FirstOrDefault (sau Find) și răspunde 404 când rezultatul e null. Microsoft.Data.Sqlite.SqliteException (0x80004005): SQLite Error 19: 'UNIQUE constraint failed: Utilizatori.Email'. Încerci să inserezi o valoare care există deja într-o coloană cu index unic (aici Utilizatori.Email). Verifică înainte dacă valoarea există și răspunde 409 Conflict, iar ca plasă de siguranță prinde DbUpdateException pentru inserările simultane. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
