Tools
Interactive print troubleshooter
Start from a symptom, then walk priority-ordered checks. Completing a test does not eliminate a cause and does not assign a probability.
How this tool uses its sources
Methodology
Data freshness
Dataset verification
Reading the evidence
Open the evidence beside a result to inspect its source and observation date. An unknown value means the available sources do not establish it.
Troubleshoot the symptom before buying the cure
A bad print is evidence. Changing eight settings before the next attempt is an efficient way to destroy the context around it.
Start with three facts: what changed, where the defect appears, and when it first occurs. Keep the slicer project, printer/material profile and a photograph with orientation marked. “It looks wrong” is an understandable reaction; it is not yet a testable description.
Classify before adjusting
| Observation | First useful question | Keep this evidence |
|---|---|---|
| First layer detaches | Surface preparation or first-layer setup? | Surface type and underside photo |
| Thin or missing extrusion | Is material delivery obstructed or the requested flow excessive? | Spool path, speed region and profile |
| Fine strands between features | Are they at travel moves? | Nozzle condition and retraction preset |
| Corners lift | At what stage does the part separate? | Geometry, surface and environment |
| Abrupt sideways displacement | Which axis moved? | Height, displacement and motion checks |
| Repeated echoes near edges | Are they directional vibration artifacts? | Axis, acceleration and mechanical changes |
| Repeating horizontal bands | Does spacing repeat in the part or motion system? | Several measured band positions |
| Weak layers | What load direction and process produced failure? | Orientation, material condition and break photo |
| Blobs or seams | Does the defect match the slicer’s seam preview? | Preview and matching part location |
| Wrong fit | Is the error local, directional or consistent? | Measurement method and mating part |
These are investigation prompts, not rules proving a cause. A single photograph rarely separates wet material, excessive flow, nozzle contamination and a mismatched profile.
First-layer failures
Check the exact sheet and its care instructions, then the machine’s first-layer procedure. Prusa’s guide documents several routes to the same visible failure; choosing a corrective action requires identifying the setup, not memorizing one offset. First layer issues
If material is not adhering, stop before it forms a moving clump. Repeat a small unchanged test after the justified correction. If a clean surface still fails, record that result; it narrows the question instead of making the cleaning effort wasted.
Extrusion and stringing
Check material identity and the feed path before retuning. If under-extrusion appears only in fast, wide extrusions, inspect the requested volumetric flow and the profile’s limit. PrusaSlicer limits flow using the more restrictive applicable maximum; a travel-speed headline does not tell you how much polymer the hotend can process. Max volumetric speed
For strings between islands, inspect nozzle contamination and the matching retraction/temperature profile. Prusa’s stringing guide describes both settings and hardware checks. Do not transplant a retraction distance between different extrusion systems. Stringing and oozing
Motion and surface patterns
A layer shift is a displacement, not merely a rough wall. Mark the affected axis and use its documented obstruction, belt and pulley checks. Layer shifting
Ringing is a different pattern: repeated echoes after geometry changes. Klipper’s resonance guidance starts with mechanical checks and then a supported measurement/tuning procedure. It does not make input shaping a cure for all uneven walls. Resonance Compensation
For repeated bands, measure the spacing at several heights and compare different faces. Treat lead-screw, extrusion and thermal explanations as hypotheses until a discriminating test supports one. Do not publish a diagnosis based solely on a visually similar forum photograph.
Worked example: a hole that will not accept its pin
This example contains no measured results. The part completed, but its pin does not fit.
- Confirm the source dimensions and intended clearance in the CAD model.
- Identify the pin by measuring the actual component; a nominal label is not its measured diameter.
- Measure the printed opening with a suitable method and record orientation. Small internal features can be difficult to measure reliably with caliper jaws.
- Print a short series of labeled coupons in the same material and orientation.
- Enter observations in the Fit and Fastener Workbench. Keep supplier specifications separate from what you measured.
- Choose the coupon that meets the intended assembly behavior and verify it in the real part before changing a global scale factor.
See the hole you drew for the distinction between a design dimension and a manufactured feature.
Close one test before opening five more
Write a sentence in this form: “I changed X because Y would explain the symptom; the repeated test showed Z.” If Z is unknown, the test is incomplete. If the symptom disappeared after several uncontrolled changes, keep the working profile but do not claim you identified the cause.
Use the controls above to follow the available reviewed troubleshooting steps. The G-code Microscope can connect supported commands to a suspicious region; unsupported commands limit its conclusions. Heater/sensor faults, damaged wiring or unsafe motion require the machine’s service process, not another speculative test print.
Sources
- First layer issues — Prusa Research. Reviewed 15 September 2026.
- Max volumetric speed — Prusa Research. Reviewed 15 September 2026.
- Stringing and oozing — Prusa Research. Reviewed 15 September 2026.
- Layer shifting — Prusa Research. Reviewed 15 September 2026.
- Resonance Compensation — Klipper maintainers. Reviewed 15 September 2026.