Identificación y solución del problema N+1 en Rails

Resolver el N+1 query problem en Rails es clave para mejorar rendimiento sin cambiar el comportamiento. Aquí verás cómo diagnosticar con RSpec, leer los logs en pruebas y aplicar la solución más simple usando includes en el controlador. Todo con pasos claros y verificables.

¿Cómo identificar el n más uno query problem con RSpec y logs?

Para confirmar el problema, se ejecuta una sola prueba y se monitorean los logs del entorno de test. Así observas si hay múltiples SELECT repetidos en la tabla relacionada, señal inequívoca del N+1.

¿Cómo ejecutar una sola prueba con RSpec?

• Ubicar la línea de la prueba: línea 29.
• Obtener el path de la prueba: spec/requests/posts.
• Ejecutar en la terminal: bundle exec rspec spec/requests/posts:29.
• Verificar que solo corre esa prueba.

¿Cómo monitorear los logs en logs/test.rb con tail -f?

• Ir a la carpeta de logs y abrir el archivo de pruebas: logs/test.rb.
• Limpiar el archivo para empezar desde cero.
• Si se borró, recrearlo y luego correr: tail -f logs/test.rb.
• En otra terminal, repetir bundle exec rspec spec/requests/posts:29.
• Observar en el log: primero un SELECT de los posts publicados y luego múltiples SELECT users * repetidos varias veces. Eso confirma el N+1.

¿Cuál es la solución simple con includes en el controlador de posts?

La forma más directa es usar includes para precargar la relación. Rails hace un solo query para la colección relacionada, evitando los múltiples SELECT por cada fila.

# posts_controller.rb
class PostsController < ApplicationController
  def index
    @posts = Post.includes(:user)
  end
end

• Se incluye el modelo relacionado: :user.
• Rails extrae los IDs de usuarios de los posts y hace un solo query para traerlos.
• No cambia el comportamiento de la respuesta ni rompe pruebas.

¿Qué cambia en los logs tras aplicar includes?

• Antes: un SELECT de posts publicados + diez SELECT a users (11 queries).
• Después: dos queries totales, uno para posts y uno para todos los usuarios relacionados.
• Impacto estimado: si cada query cuesta 100 ms, pasar de 11 a 2 ahorra ~1 segundo.

¿Qué habilidades y conceptos clave se aplican?

Dominar estos puntos acelera el diagnóstico y la solución en proyectos Rails.

• N más uno query problem: múltiples queries a la tabla relacionada por cada fila de la colección. Degrada el rendimiento.
• Ejecución focalizada con RSpec: bundle exec rspec spec/requests/posts:29 reduce el tiempo de análisis.
• Lectura de logs en pruebas: uso de logs/test.rb para ver los SELECT ejecutados.
• Monitoreo en tiempo real: tail -f para observar cómo se disparan los queries.
• Verificación del patrón: un SELECT de posts publicados seguido de muchos SELECT users * indica N+1.
• includes en Rails: precarga de asociaciones para convertir muchos queries en uno solo por relación.
• Controlador de posts: aplicar Post.includes(:user) al construir la colección.
• Métrica práctica: de 11 queries a 2, con ahorro notable de tiempo por petición.

¿Te pasó algo similar con otras asociaciones? Cuéntalo y comparte qué mejoras viste en tus logs al aplicar includes.