Failure Lab · Diagnostic Guide
Diagnosing print failures without guessing
A symptom-to-mechanism method for learning from failed builds instead of changing five settings and hoping.
- Level
- Beginner
- Reading time
- 15 minutes
- Evidence
- evidence-led
- Reviewed
- 2026-07-29

Jump through this guide
The short version
A useful failure diagnosis separates the visible symptom from the physical mechanism and the mechanism from its possible causes. “Stringing,” “warping,” or “layer shift” describes an observation, not one guaranteed fix. Manufacturer troubleshooting documentation shows that common symptoms can involve model integrity, adhesion, temperature, material delivery, supports, or abnormal motion 1. Preserve evidence, identify when and where the deviation began, test the simplest plausible mechanism, and change one controlled factor at a time.
After reading, you can
- Write an observation that does not smuggle in an assumed cause
- Build and test a short causal tree for a failed print
- Know when to stop troubleshooting and address a safety or maintenance issue
01
Preserve the scene
Before removing the part, photograph the entire build, its orientation, the platform, support, debris, and display or error message. Record the job identifier, model revision, prepared file, machine, material, start time, operator, environment, and any intervention. If safe, note whether the machine is still heating, moving, extruding, exposing, recoating, or reporting a sensor state. Do not reach into active equipment to save evidence.
The location and timing of the first deviation are more informative than the final mess. A detached first layer that later creates a nest of filament differs from a mid-build collision that knocks over a sound base. A consistent horizontal shift suggests a different causal branch from randomly missing extrusion. Prusa’s troubleshooting library distinguishes first-layer issues, under-extrusion, warping, layer shifting, support failure, delamination, and resin-specific failures because each observation narrows the search differently 1.
- What is visibly different from the intended result?
- Where is the first bad layer, region, or event?
- Did the problem repeat at the same geometry or machine position?
- What changed since the last known-good build?
02
Trace material delivery
Missing or inconsistent material can originate before, inside, or after the delivery system. For filament extrusion, inspect spool drag, tangles, moisture symptoms, drive engagement, heat-zone condition, nozzle restriction, temperature sensing, volumetric demand, and whether the commanded path actually includes the region. A partial obstruction may produce intermittent thin lines; a too-high flow request can resemble a clogged nozzle; and a geometry error can look like under-extrusion when no path was generated.
For resin, powder, paste, wire, or binder, map the equivalent chain: feedstock condition, storage, metering, spreading or pumping, energy or cure action, atmosphere, and waste or return path. Do not apply a filament fix to a photopolymer symptom simply because both created a missing feature. Start with the process mechanism.
03
Trace adhesion, heat, and geometry
Adhesion failures can occur at the platform, between layers, within supports, or at a joined interface. Surface contamination, insufficient contact, excessive or insufficient energy, thermal contraction, peel force, weak support geometry, or an unstable part can contribute. A larger brim may mask a dirty or damaged surface; more exposure may enlarge features and make resin brittle; higher temperature may improve bonding while increasing deformation or emissions.
Geometry creates local process challenges. Tall slender parts amplify vibration and leverage. Abrupt cross-section changes alter thermal mass. Long bridges lack support beneath a span. Closed cavities trap powder or resin. Fine isolated features may cool or overheat differently from a solid region. Review the sliced or exposed representation, not only the original model. Prusa recommends previewing generated G-code and checking geometry warnings when investigating a spaghetti-style failure 2.
- Platform condition and setup
- Contact area, orientation, and support stability
- Local heat or cure balance
- Contraction, peel, recoating, or nozzle forces
- Toolpath continuity and model integrity
04
Trace motion and machine health
Layer shifts, repeating surface waves, inconsistent height, collisions, or skew can arise from loose pulleys, belt or screw problems, obstructed movement, lost motor synchronization, frame movement, unstable mounting, electrical interruption, overheating drivers, incorrect limits, or a path beyond the envelope. Inspect safely and compare the artifact with machine coordinates. A flaw occurring at the same machine position across different models suggests another path than a flaw tied to the same model feature.
Do not tune around a mechanical defect. Compensation and lower speed may reduce symptoms while a loose component continues to deteriorate. Follow the manufacturer’s maintenance procedure, verify fasteners and motion transmission with power removed where instructed, and re-establish calibration. NIST’s test-artifact method encourages repeatable measurement of geometric accuracy and surface roughness to assess machine performance after maintenance or recalibration 3.
05
Run a controlled experiment
Write a hypothesis in physical terms: “the first layer detached because surface contamination reduced adhesion” is testable; “the printer hates this model” is not. Choose the lowest-risk observation or experiment that separates competing causes. Clean according to the surface maker’s method and repeat a small adhesion artifact; inspect a preview; substitute a known-good material; measure extrusion mass; or print a standard artifact. Change one main factor when possible and keep all others recorded.
Define success before the test. A visually complete part may still be dimensionally wrong or weak. Measure the feature connected to the failure and repeat enough to distinguish a stable improvement from chance. NIST emphasizes that process variability, accuracy, surface quality, material consistency, and qualification require measurements and reference data, not only visual judgment 4. Add the result to the job record so the next failure starts from evidence rather than folklore.
- Observation
- Plausible mechanisms
- Safest discriminating test
- Expected result for each mechanism
- Measured outcome
- Decision and next controlled change
Working vocabulary
Glossary
- Symptom
- An observed departure from the intended build, described without assuming its cause.
- Mechanism
- The physical process that produced the observed departure.
- Causal tree
- A structured set of possible causes connected to an observed outcome.
- Known-good baseline
- A documented configuration or specimen that previously met the selected check.
- Controlled variable
- A factor held constant so the effect of a deliberate change can be evaluated.
- Nonconformance
- Failure to satisfy a stated requirement.
Source ledger
References and further study
Numbered citations point to the sources below. We favor standards, government laboratories, peer-reviewed research, and primary technical documentation. A link is evidence for the claim it supports—not an endorsement of every claim on that website. Read the full editorial and correction method.
- Print Quality TroubleshootingPrusa Research · manufacturer technical documentation↗Opens in a new tab
- Spaghetti monster: causes and troubleshootingPrusa Research · manufacturer technical documentation↗Opens in a new tab
- NIST Additive Manufacturing Test ArtifactNational Institute of Standards and Technology · government test method resource↗Opens in a new tab
- Measurement Science for Additive Manufacturing ProgramNational Institute of Standards and Technology · government research program↗Opens in a new tab
- Additive manufacturing safetyNational Institute for Occupational Safety and Health · government safety guidance↗Opens in a new tab