---

name: troubleshoot-print-issues locale: caveman-ultra source_locale: en source_commit: 82c77053 translator: "Julius Brussee homage — caveman" translation_date: "2026-05-03" description: > Diagnose and fix common 3D printing failures through systematic symptom analysis. Covers adhesion, stringing, layer shifts, warping, and under/over-extrusion issues. Use when a print fails during the first layer or partway through, finished prints have quality defects (stringing, blobs, gaps), dimensional accuracy issues occur (warping, elephant foot), layer adhesion fails, or new material or hardware changes are causing inconsistent results. license: MIT allowed-tools: Read Write Edit Bash Grep Glob WebFetch metadata: author: Philipp Thoss version: "1.0" domain: 3d-printing complexity: intermediate language: multi tags: 3d-printing, troubleshooting, fdm, sla, print-quality, failures

Troubleshoot Print Issues

Diag + fix 3D print failures via systematic symptom analysis. Covers FDM + SLA: bed adhesion, stringing, layer shifts, warping, under-extrusion, over-extrusion, quality defects. Structured: ID symptom → root cause → iterative fix.

Use When

• Print fails first layer|midway
• Quality defects (stringing, blobs, gaps, rough surfaces)
• Dim accuracy (over/undersized, warping, elephant foot)
• Layer adhesion (delamination, splitting)
• Support removal damages|supports fail
• Prints differ from slicer preview
• Material inconsistent across prints
• New material|printer|env causing issues

In

• failure_description: What went wrong (failed first layer, stringing, warping, etc.)
• failure_timing: When (first layer, midprint, height, top)
• material: Filament|resin type, brand, age, storage
• printer: Make/model, nozzle size, bed type, enclosure
• recent_changes: New material, slicer settings, hw mods, env
• print_history: Model usually works? Material worked before?

Do

1. Collect Symptoms

Doc observable symptoms specifically:

Visual:

• Photos (overall, close-up, defect)
• Failure location (first layer, height, top)
• Defect: gaps, blobs, strings, shifts, cracks

Env:

• Ambient temp during print
• Humidity
• Drafts|AC
• Time of day (temp changes)

Print params:

# Extract from G-code metadata
grep "^;MAXX\|^;MINX\|^;MAXZ" failed_print.gcode  # Print dimensions
grep "^;PRINT_TIME:" failed_print.gcode  # Estimated time
grep "^M104\|^M140" failed_print.gcode | head -5  # Temperatures
grep "^;generated by" failed_print.gcode  # Slicer version

Got: Detailed symptom desc w/ photos, params, env ctx.

If err: Symptoms unclear → print calibration test (temp tower, stringing test, benchy) → reproduce + observe systematically.

2. Classify by Pattern

Match symptoms → common failure modes:

Diagnostic Reference Table

Symptom	Likely Causes	Quick Check	Priority Fix
Poor bed adhesion	Dirty bed, wrong temp, too high Z	Wipe bed, level bed	Clean bed, adjust Z-offset down 0.05mm
Stringing	Too hot, insufficient retraction	Check nozzle temp	Lower temp 5°C, increase retraction +0.5mm
Layer shifts	Loose belts, too fast, collision	Check belt tension	Tighten belts, reduce speed 20%
Warping	Poor adhesion, fast cooling	Check corners lifting	Add brim, enclose printer, increase bed temp
Under-extrusion	Clog, low temp, wrong flow	Check extrusion consistency	Clean nozzle, increase temp 5°C, calibrate e-steps
Over-extrusion	High flow rate, wrong e-steps	Check blob formation	Reduce flow 2-5%, calibrate e-steps
Elephant foot	First layer squish, bed too hot	Measure base width	Raise Z-offset +0.05mm, lower bed temp 5°C
Gaps in walls	Thin walls, under-extrusion	Check wall thickness	Enable thin wall detection, increase flow
Layer delamination	Low temp, poor cooling, contamination	Check layer lines	Increase temp 5-10°C, check wet filament
Blobs/zits	Retraction, coast settings	Check seam alignment	Tune retraction, enable coasting
Rough top surface	Insufficient top layers, ironing	Count solid top layers	Add 2 top layers, enable ironing
Sagging overhangs	Insufficient cooling, too hot	Check part cooling fan	Increase cooling, lower temp, add supports

Got: Failure → 1-3 most likely categories.

If err: Multi categories → prioritize by failure timing (first layer first → midprint → top surface).

3. Root Cause Analysis

Investigate underlying cause, not just symptoms:

5 Whys:

Symptom: Print warping and lifting from bed
Why? → Poor bed adhesion in corners
Why? → Corners cooling faster than center
Why? → Room draft from AC vent
Why? → No enclosure to maintain stable temperature
Why? → ABS requires heated chamber for uniform cooling

Root cause: Material choice (ABS) incompatible with open printer in drafty room

Common root causes by category:

Mechanical:

• Loose belts, pulleys, set screws
• Worn|dirty linear bearings|rods
• Z-axis binding|misalign
• Extruder gear worn|skipping

Thermal:

• Temp sensor drift|fail
• Inadequate heated bed power|insulation
• Insufficient part cooling
• Env temp swings

Material:

• Wet filament (hygroscopic)
• Old|degraded
• Contaminated (dust, oils)
• Wrong material for app

Config:

• Incorrect e-steps cal
• Wrong flow rate multiplier
• Slicer bug|wrong profile
• Firmware accel|jerk too high

Got: Root cause ID'd w/ supporting evidence (measured temps, belt tension, visual).

If err: Root cause unclear → elimination: fix most likely → re-test → repeat.

4. First-Level Fixes

Poor Bed Adhesion

Immediate:

1. Clean bed thoroughly Glass/PEI: Isopropyl alcohol 90%+ BuildTak: Warm water and dish soap

2. Level bed (paper test at 4 corners + center) Paper should drag slightly

3. Adjust Z-offset down (squish first layer more) Start: -0.05mm increments until lines fuse

4. Increase bed temperature +5°C

5. Add adhesion aid:

   • Glue stick (PLA/PETG)
   • Hairspray (ABS)
   • ABS juice (ABS) - ABS dissolved in acetone
   • Magigoo/3D printing adhesive

Slicer:

• First layer height: 0.2-0.3mm (thicker = better squish)
• First layer speed: 20mm/s (slower = better adhesion)
• Brim: 8-10mm small footprint
• Raft: difficult materials (TPU, Nylon)

Got: First layer adheres no lifting.

If err: Check bed flatness w/ feeler gauge|mesh level → warped bed needs glass/PEI or mesh comp.

Stringing

Temp-first:

1. Print temperature tower (180-220°C in 5° steps for PLA)
2. Identify lowest temperature that extrudes cleanly
3. Use that temperature -5°C to minimize stringing

Retraction:

# Direct drive extruder:
retraction_distance: 1.0-2.0mm
retraction_speed: 40-50mm/s

# Bowden extruder:
retraction_distance: 4.0-6.0mm
retraction_speed: 40-60mm/s

# If stringing persists:
- Enable z-hop: 0.2-0.4mm (lifts nozzle during travel)
- Reduce travel speed (paradoxically helps)
- Enable combing mode (travels within infill)

Got: Minimal stringing, thin strings hand-removable.

If err: Check nozzle partial clog|wet filament (both cause oozing).

Layer Shifts

Mech checks:

1. Check belt tension (should twang like guitar string) Tighten if loose

2. Check pulley set screws (motor shafts) Must align with flat on motor shaft

3. Check for mechanical resistance Manually move X/Y axes - should glide smoothly Binding indicates dirty rods, worn bearings, or misalignment

4. Check stepper motor current (advanced) Too low → skipping; too high → overheating

Speed reduction:

# Reduce these speeds:
perimeter_speed: 40mm/s (from 50)
travel_speed: 120mm/s (from 150)
acceleration: 500mm/s² (from 1000)
jerk: 8mm/s (from 15)

Got: No shifts in re-print w/ tightened belts + reduced speeds.

If err: Slicer-gen collisions (cooling fan hitting model)|electrical (stepper driver overheating).

Warping

Thermal:

# Increase bed temperature:
PLA: 60°C → 65°C
PETG: 80°C → 85°C
ABS: 100°C → 110°C

# Disable/reduce part cooling:
first_layer_fan: 0%
regular_fan: 25% max (ABS), 50% (PETG), 100% (PLA)

# Enclose printer (critical for ABS/ASA):
- Cardboard box (temporary)
- Acrylic panels (permanent)
- Target chamber temp: 40-50°C

Adhesion enhancement:

• Brim: 10-15mm corners
• "Mouse ears": 15mm discs at sharp corners
• Chamfer bottom edges (45° × 1mm removes stress concentrator)

Got: Part stays flat, no corner lifting.

If err: Material unsuitable for printer (ABS unenclosed) → switch PETG|ASA.

Under-Extrusion

Quick:

1. Check for nozzle clog Heat to print temp, manually push filament Should extrude smoothly

2. Cold pull cleaning (if partial clog) Heat to 220°C, push cleaning filament through Cool to 90°C, pull sharply - should remove debris

3. Increase temperature +5-10°C Higher temp = better flow

4. Increase flow rate 2-5% Slicer: Filament settings → Flow → 102-105%

E-steps cal:

1. Mark filament 120mm above extruder
2. Extrude 100mm: G1 E100 F100
3. Measure remaining distance to mark
4. Calculate: new_steps = current_steps × (100 / actual_extruded)
5. Set: M92 E<new_steps>; M500 (save to EEPROM)

Got: Consistent extrusion, no gaps in perimeters|infill.

If err: Heat creep (cooling fan fail)|worn extruder gear|cracked extruder arm.

Over-Extrusion

Flow reduction:

# Reduce flow in 2% increments:
extrusion_multiplier: 0.98 → 0.96 → 0.94

# Signs of correct flow:
- Smooth top surface (not overstuffed)
- Perimeters don't bulge outward
- Infill doesn't overfill and push layers apart

Dim accuracy test: Print 20mm calibration cube Measure with calipers: X/Y dimensions should be 20.0mm ± 0.1mm If consistently oversized → reduce flow If undersized → increase flow

Got: Accurate dims, smooth surfaces, no bulging.

If err: Re-cal e-steps (may be too high).

5. Verify w/ Test Print

Confirm before full print:

Test selection:

• Adhesion: 20mm sq × 5 layers (fast first layer test)
• Stringing: Stringing test model (dual towers w/ travels)
• Layer shifts: Tall thin (stress mechanical)
• Warping: Large flat (200mm × 200mm × 0.4mm)
• Extrusion: 20mm cal cube (dim accuracy)

Got: Test succeeds, issue resolved.

If err: Test fails → not fully resolved or multi issues → repeat diagnosis on remaining symptoms.

6. Doc Solution

Issue log template:

date: 2026-02-16
issue: "Layer shifts at 50mm height"
symptoms: "X-axis shifts 10mm, happens consistently at same height"
printer: "Ender 3 V2"
material: "PETG, PolyMaker PolyLite"
root_cause: "Loose X-axis belt, pulley set screw not on flat"
solution:
  - "Tightened X-axis belt to 120Hz resonance"
  - "Realigned pulley set screw on motor shaft flat"
  - "Reduced print speed to 40mm/s perimeter"
verification: "Printed 100mm test cylinder - no shifts"
notes: "Check belt tension monthly, pulley tends to slip"

Got: Issue documented w/ root cause + solution → knowledge base.

If err: Even unsuccessful attempts logged → avoid repeating failed solutions.

Check

• Symptoms documented w/ photos + observations
• Issue classified via diagnostic table
• Root cause ID'd (mechanical, thermal, material, config)
• Fix applied per root cause category
• Fix verified w/ test print before full
• Solution documented in issue log w/ date, cause, resolution
• Env factors recorded (temp, humidity, drafts)
• Material condition checked (dry, contamination-free, stored)

Traps

1. Multi vars at once: One param at a time → otherwise won't know what fixed
2. Ignore wet filament: Hygroscopic (Nylon, TPU, PETG) absorb moisture → bubbling, stringing, poor adhesion → suspect first
3. Skip mech checks: Loose belts + worn parts cause issues no slicer tuning can fix
4. Temp from internet: Every printer/material combo unique → run own temp tower
5. Over-tighten belts: Too tight → premature bearing wear → guitar string tension, not steel cable
6. Blame slicer: Bugs rare → 95% mechanical|thermal|material
7. No clean nozzle: Partial clogs → intermittent under-extrusion looks like flow/e-step
8. Assume bed level: Beds warp, springs compress, adjustments slip → re-level weekly
9. Wrong Z-offset: Most first-layer fails = Z too high (no squish) or too low (scraping)
10. Env neglect: ABS/ASA in 15°C garage w/ drafts won't print → needs stable warm

→

• prepare-print-model: Properly prepared model → avoid printability issues
• select-print-material: Material appropriate for printer + env
• Calibrate 3D Printer (future): E-steps, flow rate, temp towers, PID tuning, bed mesh
• Maintain 3D Printer (future): Belt tensioning, bearing lube, nozzle replace, preventive maint