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.