Diagnostic catalog
These 12 exception routes cover the pinned public JAX exception exports.
| Exception | Repair guide |
|---|---|
ConcretizationTypeError |
JAX-TRACE-001 |
UnexpectedTracerError |
JAX-TRACE-002 |
TracerBoolConversionError |
JAX-TRACE-003 |
TracerIntegerConversionError |
JAX-TRACE-004 |
TracerArrayConversionError |
JAX-TRACE-005 |
NonConcreteBooleanIndexError |
JAX-TRACE-006 |
InconclusiveDimensionOperation |
JAX-SHAPE-001 |
JaxprTypeError |
JAX-TRANSFORM-001 |
JAXTypeError |
JAX-TYPE-001 |
JAXIndexError |
JAX-INDEX-001 |
KeyReuseError |
JAX-RNG-001 |
JaxRuntimeError |
JAX-RUNTIME-001 |
Symptom routes
| Evidence | Repair guide |
|---|---|
| Pallas or Mosaic failure | JAX-KERNEL-001 |
| Device memory exhaustion | JAX-MEM-001 |
| NaN or Inf | JAX-NUM-001 |
| Orbax restore or resume mismatch | JAX-RESTORE-001 |
| Distributed initialization or collective failure | JAX-DIST-001 |
| Sharding or mesh mismatch | JAX-SHARD-001 |
| Disallowed transfer | JAX-TRANSFER-001 |
| Donated or deleted buffer | JAX-BUFFER-001 |
| Backend initialization | JAX-BACKEND-001 |
| Recompilation or slow tracing | JAX-COMPILE-001 |
| Flax state or scope mismatch | JAX-STATE-001 |
| Cross-framework drift | JAX-PARITY-001 |
| Gradient or custom derivative | JAX-GRAD-001 |
| Mapped axes or scan carry | JAX-AXIS-001 |
| Shapes or broadcasting | JAX-SHAPE-002 |
| Type promotion or dtype | JAX-TYPE-001 |
A generic backend exception can route to a more specific guide when the message contains a recognized symptom. Inspect the original cause and device status before deciding what to change.