Eloquent : éliminer les requêtes N+1 avec preventLazyLoading et le chargement anticipé

21 Nov 2026 | Développement Web et Mobile

Eloquent : éliminer les requêtes N+1 avec preventLazyLoading et le chargement anticipé

Votre liste d'articles s'affiche en 2 secondes alors que la base ne contient que quelques centaines de lignes ? Il y a de fortes chances qu'il s'agisse du problème N+1, le défaut de performance le plus courant dans les applications Laravel. Bonne nouvelle : Eloquent fournit tout ce qu'il faut pour le détecter et le corriger.

Qu'est-ce que le problème N+1 ?

$posts = Post::latest()->take(50)->get();   // 1 requête

foreach ($posts as $post) {
    echo $post->category->name;              // 1 requête par article
}

Une requête pour la liste, puis une requête par élément pour charger la relation : 51 requêtes pour 50 articles. Ajoutez l'auteur et les tags, et l'on dépasse vite les 150 requêtes par page. Chacune est rapide, mais leur somme pèse lourd, surtout quand la base n'est pas sur le même serveur.

Le corriger : le chargement anticipé

$posts = Post::with(['category', 'user', 'tags'])
    ->latest()
    ->take(50)
    ->get();                                  // 4 requêtes au total

with() charge chaque relation en une seule requête pour tous les articles. Les variantes utiles :

  • load() : charger une relation après coup sur une collection déjà récupérée.
  • withCount('comments') : obtenir un compteur sans charger les commentaires.
  • with(['comments' => fn ($q) => $q->latest()->limit(3)]) : contraindre la relation chargée.
  • with('category:id,name,slug') : ne sélectionner que les colonnes nécessaires (en gardant la clé).
Écran d'ordinateur affichant du code et du texte
Photo : Unsplash

Le détecter automatiquement : preventLazyLoading

Plutôt que de chercher les N+1 à la main, demandez à Laravel de lever une exception dès qu'une relation est chargée paresseusement :

// app/Providers/AppServiceProvider.php
use Illuminate\Database\Eloquent\Model;

public function boot(): void
{
    Model::preventLazyLoading(! $this->app->isProduction());
}

En local et dans les tests, toute relation oubliée provoque une erreur explicite. En production, le code continue de fonctionner. Pour être prévenu en production sans casser la page, journalisez plutôt :

Model::handleLazyLoadingViolationUsing(function ($model, string $relation) {
    logger()->warning('Lazy loading', [
        'model' => $model::class,
        'relation' => $relation,
    ]);
});

Depuis les versions récentes de Laravel, Model::shouldBeStrict() active d'un coup cette protection et deux autres (attributs inexistants, assignation de masse silencieuse).

Les pièges fréquents

  • Les vues Blade et composants Livewire qui accèdent à une relation non prévue par le contrôleur.
  • Les API Resources : une ressource qui affiche $this->user->name provoque un N+1 sur une collection. Utilisez whenLoaded('user') et chargez la relation dans le contrôleur.
  • Les accesseurs qui utilisent une relation : invisibles dans la vue, coûteux en boucle.
  • Les compteurs calculés avec $post->comments->count() au lieu de withCount().

Mesurer avant et après

Laravel Debugbar ou Telescope en local, Pulse ou votre outil d'APM en production affichent le nombre de requêtes par page (voir notre article sur la supervision d'une application Laravel). Vous pouvez aussi fixer une limite dans un test :

use Illuminate\Support\Facades\DB;

test('la page blog reste sous 10 requêtes', function () {
    Post::factory()->count(30)->published()->create();

    DB::enableQueryLog();
    $this->get('/blog')->assertOk();

    expect(count(DB::getQueryLog()))->toBeLessThan(10);
});

Ce test échouera dès qu'un développeur réintroduira un N+1.

Conclusion

Le problème N+1 ne se voit pas en développement avec dix lignes en base ; il apparaît en production avec du vrai volume. Activez preventLazyLoading dès aujourd'hui, chargez explicitement vos relations avec with() et protégez vos pages clés par un test. Pour aller plus loin, combinez avec le cache applicatif et nos conseils pour identifier les requêtes lentes.

Commentaires (0)

Aucun commentaire pour le moment.

Laissez un commentaire