Cómo Identificar Problemas N+1 en Laravel

Q: ¿Cómo puedo identificar y solucionar el problema N+1 en Laravel?

El problema N+1 en Laravel ocurre cuando, al realizar una consulta para obtener los registros principales, se ejecuta una consulta adicional por cada registro relacionado . Esto sucede debido al uso de lazy loading en las relaciones de Eloquent. Por ejemplo, si tienes 100 publicaciones y accedes a los comentarios de cada una con $post->comments , Laravel generará un total de 101 consultas: una para obtener las publicaciones y otras 100 para cargar los comentarios. Este comportamiento puede afectar gravemente el rendimiento de tu aplicación, aumentando tanto el tiempo de respuesta como el consumo de recursos. Para identificar este problema, puedes utilizar herramientas como Laravel Debugbar o Telescope , que te permiten visualizar el número de consultas realizadas. La solución más efectiva es usar eager loading mediante el método with() . Esto permite cargar las relaciones de forma anticipada, reduciendo las consultas necesarias a una sola por cada relación involucrada.

Q: ¿Cómo puedo solucionar el problema N+1 en Laravel usando eager loading?

El problema N+1 surge cuando se generan múltiples consultas adicionales al acceder a relaciones dentro de bucles. Esto puede ralentizar significativamente tu aplicación. En Laravel, puedes evitar este problema utilizando eager loading con el método with() . Aquí tienes un ejemplo: $posts = Post::with('comments')->get(); // Carga la relación 'comments' en una sola consulta De esta forma, Laravel realiza solo dos consultas: una para los registros principales y otra para las relaciones asociadas. Si ya tienes los registros principales cargados, puedes usar el método load() para añadir las relaciones sin repetir la consulta inicial: $posts = Post::all(); $posts->load('comments'); ¿Solo necesitas el conteo de una relación? Entonces utiliza withCount() para evitar cargar datos innecesarios: $users = User::withCount('posts')->get(); Para comprobar cómo estas optimizaciones afectan al número de consultas, utiliza herramientas como Debugbar o Telescope . Al implementar estas prácticas, mejorarás el rendimiento y la velocidad de tu aplicación.

Detecta y corrige el N+1 en Laravel: usa Debugbar para localizar consultas duplicadas, aplica with()/withCount()/load() y evita lazy loading en desarrollo.

Raul Lopez

04 ene. 2026 • 11 min read

El problema de consultas N+1 en Laravel ocurre cuando una consulta inicial obtiene registros principales, pero luego se ejecuta una consulta adicional por cada registro relacionado. Esto sucede por el lazy loading en Eloquent ORM, generando múltiples consultas innecesarias que afectan el rendimiento de la aplicación. Por ejemplo, mostrar 100 publicaciones con sus autores sin precarga puede generar 101 consultas, en lugar de solo 2.

Solución rápida:

Usa eager loading con with() para precargar relaciones necesarias.
Identifica problemas con herramientas como Laravel Debugbar, que muestra consultas duplicadas.
Configura Model::preventLazyLoading() para evitar este comportamiento durante el desarrollo.

Clave: Optimizar consultas reduce tiempos de respuesta y mejora el rendimiento general. Aplicar estas prácticas ayuda a evitar cuellos de botella en proyectos Laravel.

Instalación y Configuración de Laravel Debugbar

Laravel Debugbar

Instalación de Laravel Debugbar

Laravel

Para instalar Laravel Debugbar, ejecuta el siguiente comando en tu terminal: composer require barryvdh/laravel-debugbar --dev. El uso del flag --dev asegura que esta herramienta no se incluya en los entornos de producción.

Gracias al sistema de auto-discovery de Laravel, el ServiceProvider del paquete se registra automáticamente. Sin embargo, si has deshabilitado esta función en Laravel 11 o versiones posteriores, deberás añadir manualmente Barryvdh\Debugbar\ServiceProvider::class en bootstrap/providers.php. En versiones anteriores, este registro debe hacerse en el array providers dentro del archivo config/app.php. Una vez completada la instalación, la barra de depuración aparecerá automáticamente en la parte inferior de tu navegador siempre que APP_DEBUG=true esté configurado en tu archivo .env.

Configuración de Debugbar

Para personalizar la configuración, publica el archivo correspondiente ejecutando:
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider". Esto generará un archivo config/debugbar.php, donde podrás ajustar los datos que deseas recopilar y cómo presentarlos. Aunque Debugbar se activa automáticamente cuando APP_DEBUG=true, puedes controlarlo de manera más específica añadiendo DEBUGBAR_ENABLED=true o false en tu archivo .env.

La pestaña Queries es especialmente útil para identificar problemas N+1. Al acceder a esta pestaña, puedes revisar todas las consultas SQL ejecutadas, su tiempo de ejecución y cualquier duplicado, que aparecerá marcado con una etiqueta especial. La optimización mediante eager loading puede marcar una gran diferencia: en pruebas con 1.000 usuarios, los tiempos de ejecución bajaron de 1,8 segundos a apenas 25-37 ms. Sin embargo, con 10.000 usuarios, los patrones N+1 pueden causar que la aplicación supere el límite de 60 segundos y falle.

"Use the DebugBar only in development. It can slow the application down (because it has to gather data). So when experiencing slowness, try disabling some of the collectors." - Povilas Korop, Creator of Laravel Daily

Nunca olvides configurar APP_DEBUG=false en producción, ya que Debugbar podría exponer información sensible de tu base de datos. Si notas que la aplicación se ralentiza durante el desarrollo, desactiva recolectores innecesarios en el archivo config/debugbar.php. Esto reducirá la sobrecarga y, al mismo tiempo, mantendrá la capacidad de monitorizar consultas SQL.

Con Laravel Debugbar instalado y configurado, puedes proceder a identificar y resolver problemas N+1 en tu código.

CÓMO SOLUCIONAR el PROBLEMA de N+1 en LARAVEL

Identificación de Problemas N+1 en Tu Código

Los problemas N+1 suelen pasar desapercibidos; a simple vista, el código parece correcto, pero en realidad se ejecuta una consulta adicional por cada registro mostrado. Un síntoma claro en Debugbar es cuando el número de consultas coincide con la cantidad de elementos mostrados más uno. Por ejemplo, podrías ver 21 consultas para mostrar 20 publicaciones en pantalla. Esto sucede porque Eloquent realiza una consulta inicial para obtener los registros principales y luego ejecuta consultas adicionales para recuperar los datos relacionados de cada uno. Vamos a detallar cómo estos problemas se presentan en distintos contextos de Laravel.

Problemas N+1 en Bucles Eloquent

Un escenario típico donde aparecen estos problemas es en los bucles @foreach de Blade. Esto ocurre cuando se accede a propiedades de relaciones que no se han cargado previamente en el controlador. Por ejemplo, si en una vista utilizas $post->author->name sin haber precargado la relación con with('author'), Debugbar mostrará consultas repetitivas como SELECT * FROM table WHERE id = ? para cada elemento.

"This is the most typical and common mistake in the performance of Laravel projects." - Povilas Korop, Creator, Laravel Daily

Otro error común es tratar las relaciones como métodos en lugar de propiedades. Por ejemplo, usar $author->books()->count() con paréntesis genera una nueva consulta a la base de datos en cada iteración, incluso si los datos ya se cargaron con eager loading. En cambio, $author->books->count() reutiliza los datos precargados, evitando consultas innecesarias.

Para prevenir estos problemas durante el desarrollo, puedes añadir la línea Model::preventLazyLoading(! app()->isProduction()); en el método boot de tu AppServiceProvider. Esto lanzará una excepción cada vez que se intente ejecutar una consulta N+1.

Problemas N+1 en API Resources y Vistas Blade

Blade

Los API Resources también pueden desencadenar problemas N+1 si se mapean campos de modelos relacionados sin haberlos precargado. Esto puede resultar en un escenario donde se ejecuten 101 consultas para 100 registros: una para los registros principales y 100 adicionales para los datos relacionados.

Además, los accessors en los modelos que incluyen lógica basada en relaciones pueden generar consultas N+1 sin que te des cuenta. Por ejemplo, si tienes un atributo is_active que utiliza $this->books->count() y lo empleas en vistas o recursos, cada elemento del bucle generará una consulta adicional.

Debugbar es una herramienta útil para identificar estas consultas duplicadas, ya que las marca como "duplicate" cuando se ejecuta la misma sentencia SQL varias veces con diferentes IDs. Su función de backtrace te permite localizar en qué línea del archivo Blade o del API Resource se activó la consulta.

Solución de Problemas N+1 con Eager Loading

Comparación de rendimiento: Lazy Loading vs Eager Loading en Laravel

Una vez que has identificado problemas N+1 con Debugbar, el siguiente paso es aplicar eager loading para precargar las relaciones y minimizar el número de consultas. Esta técnica permite cargar las relaciones necesarias por adelantado, reduciendo drásticamente las consultas. Por ejemplo, en lugar de ejecutar 21 consultas para una lista de 20 registros, podrías reducirlo a solo 2.

Uso de with() para Eager Loading

El método with() es clave para implementar eager loading desde el controlador. Tras confirmar la existencia del problema con Debugbar, puedes especificar cuáles relaciones deben precargarse durante la consulta inicial. Por ejemplo, en lugar de usar Book::all(), podrías emplear Book::with('author')->get(). Esto realiza una consulta para los libros y otra para los autores relacionados, utilizando una cláusula WHERE IN.

Si necesitas cargar varias relaciones al mismo tiempo, puedes pasar un array al método:

Post::with(['comments', 'author', 'tags'])->get();

Cuando trabajas con relaciones anidadas, utiliza la notación de punto. Por ejemplo, with('author.profile') cargará tanto al autor como su perfil en consultas separadas (normalmente tres consultas en total). Si solo necesitas el número de elementos relacionados, withCount('comments') es una opción más eficiente, ya que evita cargar todos los comentarios, reduciendo la complejidad y el uso de memoria.

Uso de load() y loadCount() para Carga Dinámica

Si necesitas cargar relaciones después de haber realizado la consulta inicial, puedes usar los métodos load() y loadCount(). Por ejemplo, si ya tienes una colección de modelos y luego decides cargar relaciones adicionales, load() te permite hacerlo dinámicamente:

$books->load('author');

Esto resulta útil en casos donde la lógica que define las relaciones a cargar se evalúa después de la consulta inicial.

Por otro lado, loadCount() es ideal cuando solo necesitas el conteo de registros relacionados, ya que esto reduce significativamente la carga en memoria y simplifica las consultas.

Método	Momento de uso	Impacto en consultas
with()	Durante la consulta inicial	Reduce N+1 a 2 consultas
load()	Después de recuperar modelos	Añade 1 consulta adicional
loadCount()	Después de recuperar modelos	Añade 1 consulta para conteos
withCount()	Durante la consulta inicial	Reduce el total a 1 consulta

Confirmación de Soluciones con Debugbar

Después de aplicar eager loading, revisa la pestaña "Queries" en Debugbar para asegurarte de que el número total de consultas ha disminuido. Usa el filtro "Mostrar solo duplicados" para confirmar que las consultas repetitivas han desaparecido.

Analiza la estructura de las consultas: deberías ver una única sentencia con WHERE IN que agrupe todos los IDs necesarios. Si notas que aún se ejecutan consultas duplicadas, verifica que estés accediendo a las relaciones como propiedades (por ejemplo, $author->books) y no como métodos ($author->books()), ya que este último enfoque puede desencadenar consultas adicionales incluso con eager loading aplicado.

Conclusión

Detectar y resolver problemas N+1 en Laravel es clave para que tu aplicación mantenga un rendimiento óptimo, incluso bajo cargas significativas de usuarios. Como lo expresa Ashot Arakelyan: "Fixing N+1 isn't just an optimization; it's a best practice". Aunque el lazy loading puede parecer suficiente con pocos registros, en escenarios reales puede disparar el número de consultas, comprometiendo seriamente la velocidad y eficiencia de tu aplicación. Este tipo de problemas, que se pueden identificar fácilmente con herramientas como Debugbar, requieren atención inmediata.

Con Laravel Debugbar, localizar estos puntos críticos es más sencillo. En la pestaña "Queries" puedes visualizar al instante si se están ejecutando consultas duplicadas, y el filtro "Mostrar solo duplicados" te ayudará a confirmar si el eager loading ha eliminado esas redundancias. Por ejemplo, pruebas realizadas con 200 registros muestran que el lazy loading tarda 109 ms, mientras que el eager loading reduce ese tiempo a 35 ms.

Para prevenir estos problemas, activa la detección estricta añadiendo Model::preventLazyLoading(! app()->isProduction()) en el AppServiceProvider. Esto generará una excepción durante el desarrollo cada vez que se intente cargar una relación de manera perezosa, permitiéndote corregirlo antes de que impacte a los usuarios finales. Además, utiliza métodos como with() para cargar relaciones de forma anticipada, load() para cargas dinámicas, y withCount() si solo necesitas los conteos. Ten en cuenta que los problemas N+1 pueden esconderse en lugares inesperados, como en los accessors de Eloquent, en paquetes externos como Spatie Media Library o incluso en vistas Blade, especialmente si accedes a relaciones como métodos en lugar de propiedades.

Mantén siempre Debugbar activo en tu entorno de desarrollo y crea datos de prueba realistas con Factories para simular condiciones reales de producción. Estas prácticas, junto con las estrategias mencionadas, te ayudarán a garantizar un rendimiento sólido y constante en tu aplicación.

FAQs

¿Cómo puedo identificar y solucionar el problema N+1 en Laravel?

El problema N+1 en Laravel ocurre cuando, al realizar una consulta para obtener los registros principales, se ejecuta una consulta adicional por cada registro relacionado. Esto sucede debido al uso de lazy loading en las relaciones de Eloquent. Por ejemplo, si tienes 100 publicaciones y accedes a los comentarios de cada una con $post->comments, Laravel generará un total de 101 consultas: una para obtener las publicaciones y otras 100 para cargar los comentarios.

Este comportamiento puede afectar gravemente el rendimiento de tu aplicación, aumentando tanto el tiempo de respuesta como el consumo de recursos. Para identificar este problema, puedes utilizar herramientas como Laravel Debugbar o Telescope, que te permiten visualizar el número de consultas realizadas.

La solución más efectiva es usar eager loading mediante el método with(). Esto permite cargar las relaciones de forma anticipada, reduciendo las consultas necesarias a una sola por cada relación involucrada.

¿Cómo instalar y configurar Laravel Debugbar para detectar problemas N+1?

Si quieres añadir Laravel Debugbar a tu entorno de desarrollo, estos son los pasos que debes seguir:

Instalación: Ejecuta el comando composer require barryvdh/laravel-debugbar --dev. Esto asegura que el paquete solo se instale en modo desarrollo, evitando que esté disponible en producción.
Configuración: Laravel detectará automáticamente el paquete. Sin embargo, si necesitas personalizar su configuración, puedes publicar el archivo correspondiente usando:
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
Activación: Comprueba que en tu archivo .env la opción APP_DEBUG esté configurada como true. Además, puedes habilitar o deshabilitar Debugbar directamente con la variable DEBUGBAR_ENABLED=true|false.

Cuando completes estos pasos, abre tu aplicación en el navegador. La barra de depuración aparecerá al final de la página. Una de las herramientas más útiles es la pestaña Queries, donde puedes revisar las consultas SQL y detectar posibles problemas, como el N+1.

Importante: Raúl López aconseja utilizar Debugbar exclusivamente en entornos locales y nunca en producción, ya que podría exponer información sensible.

¿Cómo puedo solucionar el problema N+1 en Laravel usando eager loading?

El problema N+1 surge cuando se generan múltiples consultas adicionales al acceder a relaciones dentro de bucles. Esto puede ralentizar significativamente tu aplicación. En Laravel, puedes evitar este problema utilizando eager loading con el método with(). Aquí tienes un ejemplo:

$posts = Post::with('comments')->get(); // Carga la relación 'comments' en una sola consulta

De esta forma, Laravel realiza solo dos consultas: una para los registros principales y otra para las relaciones asociadas. Si ya tienes los registros principales cargados, puedes usar el método load() para añadir las relaciones sin repetir la consulta inicial:

$posts = Post::all();
$posts->load('comments');

¿Solo necesitas el conteo de una relación? Entonces utiliza withCount() para evitar cargar datos innecesarios:

$users = User::withCount('posts')->get();

Para comprobar cómo estas optimizaciones afectan al número de consultas, utiliza herramientas como Debugbar o Telescope. Al implementar estas prácticas, mejorarás el rendimiento y la velocidad de tu aplicación.