How does context.Context enable clean goroutine cancellation and why is 'defer cancel()' critical?

context.Context is Go's standard mechanism for propagating cancellation, deadlines, and request-scoped values across API boundaries. Every blocking or long-running function should accept a context as its first parameter.

// Creating contexts
ctx, cancel := context.WithCancel(context.Background())
defer cancel() // ALWAYS defer — releases resources even on the happy path

ctx2, cancel2 := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel2()

ctx3, cancel3 := context.WithDeadline(context.Background(),
    time.Now().Add(30*time.Second))
defer cancel3()

// Worker that respects cancellation
func worker(ctx context.Context, jobs <-chan Job) error {
    for {
        select {
        case <-ctx.Done():
            return ctx.Err() // context.Canceled or context.DeadlineExceeded
        case job, ok := <-jobs:
            if !ok { return nil }
            if err := processWithCtx(ctx, job); err != nil { return err }
        }
    }
}

// Cancellation propagates through the context tree
parent, cancelParent := context.WithCancel(context.Background())
child1, _ := context.WithTimeout(parent, 10*time.Second)
child2, _ := context.WithCancel(parent)
cancelParent() // cancels parent, child1, AND child2 simultaneously

// What ctx.Err() returns:
// nil                           — context still active
// context.Canceled              — cancel() was called
// context.DeadlineExceeded      — deadline or timeout passed

Why always defer cancel(): failing to call cancel() leaks the goroutine that monitors the context for deadline expiry. This goroutine runs until either cancel() is called or the parent context is cancelled. In a high-traffic server, thousands of leaked monitor goroutines accumulate quickly.

Invest now in Acorns!!! 🚀
Join Acorns and get your $5 bonus!

Acorns is a micro-investing app that automatically invests your "spare change" from daily purchases into diversified, expert-built portfolios of ETFs. It is designed for beginners, allowing you to start investing with as little as $5. The service automates saving and investing. Disclosure: I may receive a referral bonus.

Invest now!!! Get Free equity stock (US, UK only)!

Use Robinhood app to invest in stocks. It is safe and secure. Use the Referral link to claim your free stock when you sign up!.

The Robinhood app makes it easy to trade stocks, crypto and more.

Webull! Receive free stock by signing up using the link: Webull signup.