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.

Guidance is priority-ordered. Completing a test does not eliminate a cause and does not estimate probability.

Choose a symptom to start.

How this tool uses its sources

Methodology

Checks appear in a documented priority order. Marking a test complete records what you tried; it does not rule out a cause or assign a probability. Your completed checks can be preserved in the URL.

Data freshness

Original archive observation watermark: . Collected updates retain separate per-field observation and retrieval dates. This date does not indicate current verification. Inspect the field evidence for time-sensitive facts.

Dataset verification

Archive SHA-256 3e2be9d5d3d0a66c2bc740872ebba257668ff18b82fcc278dcc1b6cc52b5137a. buildSurfaces: 129 · droppedOrphans: 0 · filaments: 280 · latestObservations: 2281 · marketplaceObservations: 3039 · marketplaceProducts: 2281 · nozzles: 35 · printerMaterial: 229

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.

  1. Confirm the source dimensions and intended clearance in the CAD model.
  2. Identify the pin by measuring the actual component; a nominal label is not its measured diameter.
  3. Measure the printed opening with a suitable method and record orientation. Small internal features can be difficult to measure reliably with caliper jaws.
  4. Print a short series of labeled coupons in the same material and orientation.
  5. Enter observations in the Fit and Fastener Workbench. Keep supplier specifications separate from what you measured.
  6. 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