All posts

The N+1 you can't see (it's hiding in your accessors)

Published June 20, 2026 · by Majd Ghithan, written with the help of AI

The N+1 you can't see (it's hiding in your accessors)

I've fixed hundreds of N+1 queries. The easy ones are right there in the controller — a foreach with $order->customer inside it, obvious the moment you read the code. Those aren't the ones that hurt.

The ones that hurt are the N+1s you can't see by reading the controller, because the query fires somewhere you'd never look: inside an accessor, inside an API Resource, inside a policy check, inside a Blade partial. The controller looks clean. The query count is 300. And nobody can find why, because the loop that causes it isn't written anywhere near the code that triggers it.

Here are the four hiding spots, and the one setting that drags them all into the light.

1. The accessor that loads a relation

This is the sneakiest one. Someone adds a "convenience" accessor on the model:

// User model
public function getIsPremiumAttribute(): bool
{
    return $this->subscription->plan === 'premium';
}

Reads great. $user->is_premium — clean. But $this->subscription is a relation, and if it wasn't eager-loaded, every access to is_premium fires a query. Now put $user->is_premium in a table of 200 users, and you have 200 queries generated by a property that looks like a plain boolean. Nothing in the loop mentions a query. The query is hidden one layer down, inside the accessor.

2. The API Resource that reaches for relations

// OrderResource
public function toArray($request): array
{
    return [
        'id' => $this->id,
        'total' => $this->total,
        'customer_name' => $this->customer->name,   // relation
        'item_count' => $this->items->count(),       // relation
    ];
}

OrderResource::collection($orders) maps over every order and builds this array for each one. Each $this->customer and $this->items that wasn't eager-loaded is a query — per order. The controller just says return OrderResource::collection($orders), one clean line. The N+1 lives inside the Resource, invisible from the call site.

3. The policy that queries on every check

public function view(User $user, Document $doc): bool
{
    return $doc->team->members->contains($user); // two relations
}

Now render a list of 50 documents and @can('view', $doc) in the Blade loop. The policy runs 50 times, and each run walks team then members — relations that weren't loaded because you were only thinking about the documents, not the authorization. A hundred queries generated by a permission check.

4. Lazy relations in a Blade partial

The controller passes $posts to the view. The view includes _post_card.blade.php per post, and that partial renders {{ $post->author->name }}. The N+1 isn't in your controller or even your main template — it's buried in a partial two includes deep, and it fires once per card.

The compare that explains all four

Lazy — the relation loads on access
$orders = Order::all();

// somewhere else — resource, accessor,
// policy, or partial:
$o->customer->name; // query, every time

// 200 orders = 200 hidden queries
Eager — loaded up front, once
$orders = Order::with('customer')->get();

// same access, now free:
$o->customer->name; // no query — preloaded

// 200 orders = 2 queries total

The fix is always the same — eager-load the relation with with(). The hard part was never the fix. It's finding that a relation is being touched at all, when the touch is buried three layers away from the query count.

Stop hunting. Make Eloquent refuse to lazy-load.

This is the setting that changes everything. In AppServiceProvider::boot():

use Illuminate\Database\Eloquent\Model;

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

Now, in local and staging, the instant any code lazy-loads a relation that wasn't eager-loaded, Laravel throws a LazyLoadingViolationException — and it tells you exactly which model and which relation. The accessor, the Resource, the policy, the partial: whichever one reaches for an unloaded relation blows up loudly at development time, pointing straight at the line.

You don't go looking for invisible N+1s anymore. They announce themselves the first time you hit the page. The ones that used to survive all the way to production — because 200 fast queries never actually errors, it just quietly costs you 400ms — now can't get past your local environment.

Note the ! app()->isProduction() guard: you want this loud in development and off in production, so a violation you missed degrades to a slow query rather than a 500 for a real user. Turn it on, run your app once, and fix every exception it throws. What's left is an app where the query count is honest — where reading the controller actually tells you how many queries the page runs, because there's nothing hiding a layer down anymore.

🤖 Heads up: this post was drafted with AI. Spot something wrong or off?Edit it on GitHub & open a PR
Majd Ghithan

Majd Ghithan

Full-Stack Engineer & Tech Lead

More posts

Laravel finally resizes images for you

Laravel finally resizes images for you

Every Laravel app I've built that takes an avatar ended the same way: composer require intervention/image, wire up a facade, write a little service class, and hope the next dev…

July 26, 2026Read more
What actually breaks at 100,000 users (that never breaks in a demo)

What actually breaks at 100,000 users (that never breaks in a demo)

The first time I shipped a dashboard to a hundred thousand active users, nothing I had tested was what broke. Everything that failed had passed every check I ran. It worked on m…

July 25, 2026Read more
Where your queue jobs go to die under load

Where your queue jobs go to die under load

The support ticket said "I never got my invoice email." I checked the logs. The job ran. It succeeded. failedjobs was empty. Everything said the email went out. It did not.

July 18, 2026Read more
The indexes you're missing (and the one that's hurting you)

The indexes you're missing (and the one that's hurting you)

A client sent me a query that took 4.2 seconds. One WHERE, one ORDER BY, a table with three million rows. I added a single index and it dropped to 11 milliseconds. They asked if…

July 11, 2026Read more
Caching in Laravel without the stampede

Caching in Laravel without the stampede

We cached the homepage's "trending products" query for five minutes. It was our slowest query — about 900ms, a big aggregation across orders. Caching it took the homepage from s…

July 4, 2026Read more
Taking one endpoint from 800ms to 80ms

Taking one endpoint from 800ms to 80ms

The order-details endpoint took 800 milliseconds. Not broken, just slow enough that the app felt heavy everywhere it was used. The team's instinct was "the server needs more mem…

June 27, 2026Read more
The Friday deploy that charged customers twice

The Friday deploy that charged customers twice

It was 4:40 on a Friday. The change was tiny — a one-line tweak to how we called the payment provider, plus a bump to the queue worker's timeout. Small, tested, reviewed. I depl…

June 13, 2026Read more
Code review people don't dread

Code review people don't dread

I once left forty-one comments on a junior's pull request. I was proud of it. Thorough, I told myself. The next day he barely made eye contact, and his next PR sat open for a we…

June 6, 2026Read more
Hiring a mid-level Laravel dev: the signals that actually matter

Hiring a mid-level Laravel dev: the signals that actually matter

The best hire I ever made failed my first question. I asked him to explain service containers and he stumbled, went quiet, then said "honestly I use them every day but I've neve…

May 30, 2026Read more
Saying no to a feature without being the 'no' person

Saying no to a feature without being the 'no' person

For about a year I was the engineer everyone learned to route around. Not because I was wrong, I was usually right, but because my answer to new ideas was a flat "no, that'll br…

May 23, 2026Read more
My first 90 days as a tech lead (and the habit I had to break)

My first 90 days as a tech lead (and the habit I had to break)

Three weeks into leading my first team, I stayed late to "help" by rewriting a junior's feature myself. It was faster my way. I pushed it, felt productive, went home. The next m…

May 16, 2026Read more
Breaking down the task that scares you

Breaking down the task that scares you

There's a specific kind of ticket that makes my stomach drop. Not the hard ones, hard is fine. It's the ambiguous ones. "Migrate billing to the new provider." "Add multi-tenancy…

May 9, 2026Read more
1:1s that aren't just status updates

1:1s that aren't just status updates

For my first few months as a lead, my 1:1s were thirty minutes of me asking "so, what are you working on?" and nodding at answers I already knew from standup. We both left sligh…

May 2, 2026Read more
Get the business logic out of your controllers

Get the business logic out of your controllers

I once opened a OrderController@store method that was 240 lines long. Validation, a discount calculation, three model writes, a Stripe charge, two emails, a Slack notification,…

April 25, 2026Read more
Form Requests are the most underrated thing in Laravel

Form Requests are the most underrated thing in Laravel

Most Laravel devs meet Form Requests once, in a tutorial, use them to hold a rules() array, and never look deeper. That's a shame, because a Form Request is the cleanest place i…

April 18, 2026Read more
Testing Laravel without mocking everything

Testing Laravel without mocking everything

I inherited a codebase once with 900 unit tests and no confidence. Every test mocked the repository, mocked the model, mocked the mailer, mocked the thing three layers down. The…

April 11, 2026Read more
Three Eloquent features that clean up your models

Three Eloquent features that clean up your models

The messiest Laravel model I ever wrote wasn't messy because of Eloquent. It was messy because I ignored the parts of Eloquent that exist specifically to keep it clean. The same…

April 4, 2026Read more
The migration that locked the table for eight minutes

The migration that locked the table for eight minutes

The deploy looked boring. One migration, adding a lastseenat column to the users table with a default of now(). I'd written a hundred like it. I ran it at 2pm on a Tuesday becau…

March 28, 2026Read more
Chasing a memory leak in a Laravel queue worker

Chasing a memory leak in a Laravel queue worker

The alert came in at 4am: one of our queue:work processes had been OOM-killed. The supervisor restarted it, it processed jobs for about forty minutes, and got killed again. It w…

March 21, 2026Read more