Claude Code performance

N+1 Query Problem Causing Performance Degradation

Application performance degrades significantly after adding a feature that loads related data. Profiling shows massive number of database queries (1 main query + N queries for each result). Adding 50 users slows down response by seconds instead of milliseconds.

The feature works correctly but is fundamentally inefficient, querying the database hundreds or thousands of times for what should be a few queries.

Error Messages You Might See

Application timeout after adding feature Database connection pool exhausted 50+ SELECT queries logged for single request
Application timeout after adding featureDatabase connection pool exhausted50+ SELECT queries logged for single request

Common Causes

  1. Lazy loading relationship in loop: for (user in users) { user.profile.name } triggers query per user
  2. Separate query for each item instead of batch loading
  3. Eager loading not configured, falling back to lazy loading
  4. No database indexes on foreign keys causing full table scans
  5. JOINs not used despite being available, falling back to multiple queries

How to Fix It

Enable SQL query logging to see all queries. Count them: if 51+ for 50 items, you have N+1. Use eager loading (JOIN FETCH) or explicit batch loading. Add database indexes on foreign keys. Use query analysis tools (EXPLAIN PLAN) to see join strategies. Consider denormalization or caching for expensive relationships.

Real developers can help you.

ISHANTDEEP SINGH ISHANTDEEP SINGH Senior Software Engineer with 7+ years of experience in React, JavaScript, TypeScript, Next.js, and Node.js. I’ve also worked as a tech lead for startups, owning end-to-end technical execution including architecture, development, scaling, and delivery. I bring a strong mix of hands-on coding, product thinking, and technical leadership, and I’m comfortable building products from scratch as well as improving and scaling existing systems. Pratik Pratik SWE with 15+ years of experience building and maintaining web apps and extensive BE infrastructure Matthew Jordan Matthew Jordan I've been working at a large software company named Kainos for 2 years, and mainly specialise in Platform Engineering. I regularly enjoy working on software products outside of work, and I'm a huge fan of game development using Unity. I personally enjoy Python & C# in my spare time, but I also specialise in multiple different platform-related technologies from my day job. Matthew Butler Matthew Butler Systems Development Engineer @ Amazon Web Services Matt Butler Matt Butler Software Engineer @ AWS Jen Jacobsen Jen Jacobsen I’m a Full-Stack Developer with over 10 years of experience building modern web and mobile applications. I enjoy working across the full product lifecycle — turning ideas into real, well-built products that are intuitive for users and scalable for businesses. I particularly enjoy building mobile apps, modern web platforms, and solving complex technical problems in a way that keeps systems clean, reliable, and easy to maintain. Costea Adrian Costea Adrian Embedded Engineer specilizing in perception systems. Latest project was a adas camera calibration system. Prakash Prajapati Prakash Prajapati I’m a Senior Python Developer specializing in building secure, scalable, and highly available systems. I work primarily with Python, Django, FastAPI, Docker, PostgreSQL, and modern AI tooling such as PydanticAI, focusing on clean architecture, strong design principles, and reliable DevOps practices. I enjoy solving complex engineering problems and designing systems that are maintainable, resilient, and built to scale. Jaime Orts-Caroff Jaime Orts-Caroff I'm a Senior Android developer, open to work in various fields Yovel Cohen Yovel Cohen I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How to detect N+1 problems?

Enable SQL query logging. For N items, you should see ~O(1) or O(log N) queries, not O(N). If query count = 1 + N, that's N+1 problem.

How to fix with JOINs?

Use JOIN FETCH in query: SELECT user FROM User user JOIN FETCH user.profile WHERE ... (fetches user and related profile in single query).

Should all relationships be eager loaded?

No. Load eagerly only if always used. For conditional access, use explicit loading or batch loading when needed.

Related Claude Code Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help