Redis is not a magic performance layer — wrong patterns make things worse. Cache-aside works for read-heavy entities with tolerable staleness.
Write-through fits financial balances where consistency matters more than latency.
Production upgrades rarely fail because of framework bugs — they fail when cache assumptions, auth cookies, and CDN headers were never validated together on staging that mirrors real traffic shape.
Before committing to a migration window, align product, infrastructure, and support on rollback criteria. A written go/no-go checklist prevents heroics when metrics drift after deploy.
TTL tuning should reflect business rules, not round numbers.
A 60-second product cache and a 24-hour config cache can coexist in the same cluster.
Inventory every data fetch path: server components, route handlers, and client-side SWR hooks. Tag each call with expected staleness and document who owns invalidation when upstream data changes.
Middleware and edge handlers deserve the same regression suite as API routes — especially redirects, locale detection, and auth gates that behave differently under bot traffic.
Tag-based invalidation beats global flush when catalog updates are partial.
We namespace keys by tenant and entity type from day one.
Partial prerendering and streaming change how users perceive performance. Measure first meaningful paint separately from time-to-interactive on routes that mix static shells with dynamic holes.
Document boundary decisions in ADRs so the next squad does not collapse dynamic regions back into fully static pages for short-term convenience.
Stampede protection via request coalescing saved a flash sale last November.
One line of locking logic, zero duplicate DB hits.
Staging must replay CDN cache keys, not only origin responses. We clone production cache headers and run synthetic crawls before promoting framework upgrades.
Load tests should include authenticated sessions and cart mutations — anonymous homepage tests alone miss the routes that break under cache policy changes.
Monitor evicted keys and memory fragmentation — silent
pressure manifests as latency long before OOM kills.
Dashboard cache hit ratio, RSC payload size by route, and error rate per layout segment on one screen. On-call should not hunt across three tools during an incident.
Schedule a 48-hour post-upgrade review with engineering and client stakeholders — capture what surprised you while context is fresh.
The table below summarizes the reference points we review with client stakeholders before sign-off. Use it as a shared vocabulary in sprint planning and release reviews.
Migration risk matrix
| Area | Risk level | Mitigation | Owner |
|---|---|---|---|
| Caching defaults | High | Audit fetch + revalidate usage | Platform |
| Dynamic routes | Medium | Staging parity with CDN headers | Web |
| Middleware | Medium | Edge-case test suite | Web |
| ISR pages | High | Load test under realistic traffic | SRE |
| Auth cookies | High | Cross-domain staging replay | Security |
| Observability | Medium | Dashboard per route segment | SRE |
Run through this checklist in order — skipping steps because of deadline pressure is how regressions reach production. Assign an owner for each item before you schedule a launch window.
Pre-launch gates
- Run regression suite on staging with production-like data volume.
- Validate observability dashboards and alert thresholds.
- Document rollback steps before promoting to production.
- Schedule a post-deploy review within 48 hours.
- Confirm cache headers and CDN behavior match the signed-off staging replay.
- Verify feature flags and kill switches for partial rollout paths.

