Quando invochiamo il metodo SaveChanges/SaveChangesAsync, EF Core genera i comandi SQL necessari ad aggiornare il database e, in caso di errore, solleva un'eccezione di tipo DbUpdateException che nella proprietà InnerException espone l'eccezione del provider ADO.NET. Tramite questa, possiamo indagare per scoprire quale sia stato l'errore sollevato dal database (un problema di integrità referenziale, campo not null, lunghezza tropo lunga e così via).

Tuttavia, questo modo di lavorare ci obbliga a intercettare prima l'eccezione di EF Core e poi a lavorare con la sua eccezione interna andando a leggere il codice di errore specifico del database. Se la nostra applicazione nasce per poter lavorare con database differenti, il codice diventa più complicato perchè dovremmo lavorare con i codici di errore di più tipi database.

La libreria EntityFrameworkCore.Exceptions ci viene in aiuto proprio per risolvere questo genere di problema. Una volta configurata per lo specifico tipo di database, questa libreria modifica l'eccezione sollevata da EF Core in un'eccezione specifica per il tipo di errore. Se, ad esempio, uno dei comandi SQL causa un problema di integrità referenziale, la libreria solleva una ReferenceConstraintException; se andiamo a impostare un valore null in un campo not null, la libreria solleva una CannotInsertNullException e così via. Questo approccio rende il nostro codice più semplice da gestire in quanto abbiamo un'eccezione specifica per ogni tipo di errore. Se vogliamo ulteriormente approfondire le cause del problema, nella proprietà InnerException dell'eccezione possiamo trovare l'eccezione originale del provider ADO.NET sottostante.

La librerià può essere scaricata da NuGet e si compone di un pacchetto base e di una serie di pacchetti specifici per database (che referenziano il pacchetto base). Una volta installato il package, tutto quello che dobbiamo fare per configurarlo è chiamare il metodo UseExceptionProcessor nella configurazione del DbContext.

public class MyContext : DbContext
{
  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
    optionsBuilder.UseExceptionProcessor();
  }
}

//oppure in ASP.NET in fase di startup
builder.Services.AddDbContext<MyContext>(o =>
{
  o.UseExceptionProcessor();
});

Nel codice, ci basta utilizzare un blocco try/catch per gestire le eccezioni.

using (var ctx = new MyContext())
{
  ...

  try
  {
    ctx.SaveChanges();
  }
  catch (UniqueConstraintException e)
  {
    //gestione errore
  }
  catch (CannotInsertNullException e)
  {
    //gestione errore
  }
  catch(Exception e)
  {
    //gestione errore
  }
}