Context Propagation, Cancellation & Deadlines

In Plain English

The context package is the standard Go mechanism for managing request lifecycles, cancellation trees, timeouts, and deadlines across goroutine boundaries and microservice boundaries.

The Mental Model

"A context is like a visitor badge with an expiration timer. As a request passes through multiple microservices, if the user cancels, the badge flashes red and all workers stop instantly."

Deep Dive: How It Works

Cancellation Trees: context.WithCancel creates child contexts that automatically cancel when parent cancels.

Timeouts & Deadlines: context.WithTimeout cancels automatically when duration expires.

Convention: ctx is always passed as the first parameter of functions (func DoWork(ctx context.Context, ...)).

Syntax Blueprint

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
select {
case <-workChan: ...
case <-ctx.Done(): fmt.Println(ctx.Err())
}

Create timeout context, defer cancel(), and select on <-ctx.Done() for early aborts.

Core Rules to Remember

Explicit Lifecycle: Context signals when an operation should stop work and free resources.

Always Defer Cancel: Always call defer cancel() right after WithTimeout or WithCancel to prevent timer leaks.

First Parameter: Pass context as the first explicit function parameter, never inside a struct.

Common Beginner Traps & How to Fix Them

Mistake:Storing context.Context inside a struct field instead of passing it as a function parameter.

Why it happens: Encapsulating context inside structs obscures request lifecycles and creates stale reference bugs.

How to fix: Pass ctx context.Context as the first parameter in methods.

Pro Tip: Use context.WithoutCancel(ctx) (Go 1.21+) when you need to spawn background tasks that outlive the parent request.

Live Interactive Example

Hit Run Code to see it live

Graceful Task Cancellation with Context

Go 1.22 / Runtime

Output Console

Click "Run Code" to view the rendered output.

How it works: The 10ms timeout expired before the 100ms task completed, triggering <-ctx.Done().

Your Turn: Micro Challenge

No pressure! Edit the starter code below and test your solution with instant feedback.

Micro Exercise

Manual Context Cancellation

Create a context with context.WithCancel(context.Background()).
Call cancel() immediately.
Check <-ctx.Done() inside a select block and print "Cancelled successfully: " followed by ctx.Err().

Sandbox Output

Click "Run & Check" to test your solution.

Finished reading and practicing?

Mark this lesson as completed to update your course progress.

Deep Dive: How It Works

Cancellation Trees: context.WithCancel creates child contexts that automatically cancel when parent cancels.

Timeouts & Deadlines: context.WithTimeout cancels automatically when duration expires.

Convention: ctx is always passed as the first parameter of functions (func DoWork(ctx context.Context, ...)).