Transformer Divergence Without Gradient Clipping
Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity.
Transformer models are highly sensitive to activation magnitude growth across layers.
- Root cause
- Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g.
- Recommended fix
- Implement gradient clipping before optimizer step torch.nn.utils.clip_grad_norm_(model.parameters(), max_norm=1.0) optimizer.step() Gradient clipping forcefully caps the L2 norm of the gradients to a maximum value, preventing catastrophic weight updates.
- How Denpex helps
- Denpex matches Transformer Divergence Without Gradient Clipping across every rank in a distributed run and reports which rank failed first, so you act on the initiating node instead of the loudest one.
What this failure is
Transformer Divergence Without Gradient Clipping is a Architecture failure seen during ML training runs. Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity. Common tags: Exploding Gradients.
Is this what broke your run? Paste your log.
You're reading about Transformer Divergence Without Gradient Clipping. Paste your own crash log or traceback below and get the real root cause for YOUR run, not this generic entry. No account, no card. Logs are masked at ingress and never saved to account history.
Want 14 days on the Scale plan?
Request an evaluation code. A verified workplace organization activates up to 50 diagnoses a day, alerts, history, and follow-up questions. No credit card or automatic subscription.
Why it happens (the mechanism)
Looks like the learning rate is off by orders of magnitude, when in reality transformers specifically require clipping to survive early-stage variance in self-attention weights.
What you'll observe
- Gradient norm: inf
- Loss becomes inf, then nan
Common symptoms and what they mean
| Symptom | Why it happens |
|---|---|
| Loss drops initially but then suddenly spikes exponentially. | Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity. |
| Gradient norms exceed 1000s and then hit infinity. | Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity. |
| Model outputs only `nan` values for all inputs afterward. | Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity. |
Which systems are affected
- PyTorch
- Hugging Face Transformers
- DeepSpeed
How to confirm this is the problem
Use this checklist to test the hypothesis against a small reproduction. No single line proves the root cause, so preserve the preceding events and compare one variable at a time.
- ✓Log gradient norms per step: `torch.nn.utils.clip_grad_norm_(model.parameters(), float('inf'))` to just read the norm.
- ✓Observe if the norm steadily increases right before the crash.
The fix and the prevention pattern
The root cause is on this page and stays free. A free account adds the exact remediation steps, saved history, and the fix on every entry in the encyclopedia.
Sign up free. Unlock the full analysisNo credit card. Daily allowance follows verified trust tier. Instant access.
Diagnose this failure in VS Code
Select the traceback or open the failed terminal, then run Denpex locally to see the initiating rank, collateral failures, exact fix, and verification command without uploading the log.
Install the free VS Code extensionRoot cause
- Transformer models are highly sensitive to activation magnitude growth across layers. A high learning rate or lack of layer normalization (e.g. post-LN without warmup) causes gradients to accumulate multiplicatively during backpropagation. This exceeds the dynamic range of FP16/FP32, resulting in an overflow to infinity.
The fix and how to prevent it
Evaluate Denpex on your own logs
Request a Scale evaluation code. A verified workplace organization activates 14 days with up to 50 diagnoses a day. Every account keeps its current diagnosis allowance and gets a verification path. No card or automatic subscription.
References
Don't just read the fix, diagnose your run
The encyclopedia tells you what went wrong. Denpex tells you what went wrong in YOUR training run. With your logs, your config, and your stack.