The Bug That Took 10 Minutes to Fix and 3 Days to Find

The Bug That Took 10 Minutes to Fix and 3 Days to Find

Tópico: The Bug That Took 10 Minutes to Fix and 3 Days to Find
Categoria: Tutoriais | Programação & Tecnologia
Idioma Principal: Português (Conteúdo de Tecnologia)

Descrição do Conteúdo / Informações:
-------------------------------------------------------------------------
The fix was one line.

if not items: return []

That's it Three words a colon and a pair of brackets It took me 10 seconds to type. 10 minutes to test and verify 10 seconds to deploy.

It took me 3 days to find.

Three days of staring at logs that said nothing Adding print statements that confirmed nothing Rewriting code that wasn't broken Blaming the framework Blaming the database Blaming the network Eventually quietly blaming myself.

The bug wasn't complicated It wasn't deep It was hiding in plain sight in a place I hadn't thought to look because I hadn't thought to ask the right question.

The AI had assumed a list would never be empty I had assumed the AI was right. Neither of us checked.

This is the story of how I spent 3 days debugging a bug that took 10 minutes to fix and what I learned about assumptions silent failures and the expensive gap between it works and it always works.

How It Started

The code was simple A function that processed a list of user inputs and returned a summary A small feature, maybe two hundred lines total Nothing that should have taken more than an afternoon.

I'd used AI to write the core logic The prompt was clear The output looked clean - readable, well-structured, sensible variable names I reviewed it The tests passed The PR was approved in the next morning's standup I shipped it on Tuesday.

The feature worked fine for two days Users were using it Logs were quiet I moved on to the next ticket.

Then Thursday happened.

A user with an empty list hit the endpoint No data - just an empty state, the kind that every real application encounters eventually The function received the empty list, processed it, and returned... nothing Not an error Not an empty list Not a helpful message Just silence.

The UI froze waiting for a response that wasn't coming The user was confused Support flagged it I was pulled back into code I thought was done.

The function worked 99% of the time The 1% was invisible And in production invisible is expensive.

Day 1: The Spiral

I started where anyone would the error logs Nothing No exceptions no warnings, no trace The function had been called It had returned The logs had nothing to say about what happened in between.

I added print statements Ran the code locally It worked perfectly Of course it did - I had test data which meant I had a non-empty list which meant I never triggered the bug.

I checked the database The data was there The function was definitely being called - I could see the request in the logs It returned something The UI just couldn't do anything with it.

I blamed the framework Maybe it's a caching issue Maybe the response is getting intercepted somewhere Cleared caches Nothing changed.

I blamed the network Maybe the request is timing out before the response arrives Checked latency Everything was fine.

I blamed the AI-generated code Maybe the logic is wrong in a subtle way I missed in review Rewrote the core function by hand line by line Same behavior.

By 6 PM I had rewritten three functions restarted the server twice added eleven print statements and learned absolutely nothing.

I closed my laptop The bug was still there.

So was I.

Day 2: The Desperation

I came back Friday with fresh eyes and no new ideas - the worst combination.

I traced the execution path more carefully this time Line by line watching the data flow through the function The input was received The processing ran The output was generated Everything looked right.

Except the output was wrong.

I started questioning things I hadn't questioned in years Did I actually understand the data structure I was working with? Was Python doing something I wasn't expecting with list references? Was there a mutation happening somewhere that I wasn't seeing?

I added a check to log the exact value of the input list before processing Items were there I added a check after processing The result was empty The logic in between looked correct.

I posted on Stack Overflow No answers for six hours.

I asked an AI assistant It suggested the same approaches I'd already tried, phrased slightly differently.

I pulled a colleague into a Zoom call They looked at the code for ten minutes and said It looks fine to me.

That was the worst moment of the three days Not the frustration not the wasted hours - the moment when someone else looked at it and confirmed that nothing was obviously wrong. Because that meant either I was missing something fundamental or the bug was somewhere I hadn't looked yet.

By Friday night I had genuinely started to wonder if I was going to find it at all.

Day 3: The Breakthrough

Saturday morning. Fresh coffee No notifications I opened the function again with no particular plan - just read it one more time slowly with no assumptions about where the problem was.

Same code. Same behavior But I added one more log I hadn't thought to add before:

print(f"items before processing: {items}")
print(f"items type: {type(items)}, length: {len(items)}")

The list had items. Three of them. Good — confirmed the input was right.

print(f"processed result: {processed}")
print(f"processed length: {len(processed) if processed else 'empty/None'}")

The processed result was empty.

I stared at the screen for a moment Input: three items Output: empty The logic in between: apparently correct.

Then I looked at something I had looked at a dozen times before but never really seen The function I was testing was calling a helper function I had reviewed that helper function I had read it carefully But I had read it assuming the input would always have items - because in my testing it always did.

The helper function wasn't checking It was written assuming the list would have at least one item When it did it worked correctly and returned results. When it didn't when the list was empty it entered a code path that silently returned nothing instead of an empty list.

No exception No warning No log entry Just nothing wrapped up neatly and returned as if nothing was wrong.

if not items: return []

I added the line Ran the test with an empty list The function returned an empty list.

I ran the full test suite Everything passed.

I deployed The UI loaded The user with the empty list finally saw something on their screen: an empty state message exactly what they should have seen three days ago.

The fix took 10 seconds to write and 10 minutes to verify.

Finding it took 3 days.

What the Bug Taught Me

The 99% trap is real. Code that works most of the time is significantly harder to debug than code that fails loudly and immediately The silent failure is the expensive one because it doesn't announce itself and because you'll keep testing with the cases that work and never see the case that doesn't.

Assumptions are invisible debt. The AI assumed a list would never be empty because most of its training examples involved lists that had items. I assumed the AI had handled the edge cases because the code looked complete. Neither assumption was wrong on its own they were just unchecked And unchecked assumptions in production are loans you'll repay with interest.

Works on my machine is a specific kind of lie. It works on my machine because I test with data. The bug lived in the absence of data The happy path works the happy path always works The skill is in finding the unhappy path before your users do.

The fix is almost never the hard part. Finding is hard Fixing is easy I spent 3 days finding a single unhandled edge case I spent 10 minutes fixing it. The value in software development isn't in writing code it's in knowing where to look when the code is wrong.

I should have asked what happens when this gets nothing? Before shipping Before the PR was approved. Before the tests ran That question takes 30 seconds to ask and answer It would have saved three days.

What I'm Doing Differently

Now I ask one question before I ship any function before review before testing before deployment:

What happens when this gets nothing?

Empty list Null input Missing field Zero results The case where the happy path assumption is wrong.

I don't trust AI-generated code to ask that question for me I don't trust myself to remember to ask it spontaneously So I made it a rule part of my personal pre-ship checklist right after does the happy path work.

It takes about 30 seconds to answer It would have saved me 3 days.

That's a trade-off I'll take every single time.

One Question

What's the longest you've spent debugging a bug that turned out to be a one-line fix?

Days? Hours? A week you'd rather forget?

I'll go first in the comments 3 days, one missing edge case, one line of code I still think about every time I ship a new function.

Your turn. 👇