---

name: troubleshoot-print-issues locale: caveman source_locale: en source_commit: 82c77053 translator: "Julius Brussee homage — caveman" translation_date: "2026-05-03" description: > Diagnose, fix common 3D print failures via systematic symptom analysis. Covers adhesion, stringing, layer shifts, warping, under/over-extrusion. Use when print fails first layer or partway, finished prints have defects (stringing, blobs, gaps), dimensional issues (warping, elephant foot), layer adhesion fails, or new material/hardware causes 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

Diagnose, fix common 3D print failures via systematic symptom analysis. Covers most frequent FDM, SLA issues: poor bed adhesion, stringing, layer shifts, warping, under-extrusion, over-extrusion, quality defects. Uses structured approach — symptom ID, root cause, iterative fixes.

When Use

• Print fails first layer or partway
• Finished prints have defects (stringing, blobs, gaps, rough surfaces)
• Dimensional accuracy problems (over/undersized, warping, elephant foot)
• Layer adhesion issues (delamination, splitting)
• Support removal damages part or supports fail mid-print
• Prints differ from slicer preview
• Material behaves inconsistent across prints
• New material, printer, or environment causing issues

Inputs

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

Steps

1. Collect Failure Symptoms

Document observable symptoms with specificity:

Visual inspection:

• Photos of failure (overall, close-up, defect)
• Note failure location (first layer, specific height, top surface)
• Describe defect type: gaps, blobs, strings, shifts, cracks

Environmental data:

• Ambient temperature during print
• Humidity
• Drafts or AC affecting printer
• Time of day (temp changes)

Print parameters:

# 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 description with photos, parameters, environmental context.

If fail: Symptoms unclear? Print calibration test (temperature tower, stringing test, benchy). Reproduce, observe failure systematic.

2. Classify Issue by Symptom Pattern

Match observed symptoms to 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 classified into 1-3 most likely categories.

If fail: Symptoms match multiple categories? Prioritize by failure timing — first layer first, then midprint, then top surface.

3. Root Cause Analysis

Investigate underlying cause, not 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 or misalignment
• Extruder gear worn or skipping

Thermal:

• Temp sensor drift or failure
• Inadequate heated bed power/insulation
• Insufficient part cooling
• Environmental temp swings

Material:

• Wet filament (hygroscopic materials)
• Old/degraded material
• Contaminated filament (dust, oils)
• Wrong material for application

Configuration:

• Incorrect e-steps calibration
• Wrong flow rate multiplier
• Slicer bug or wrong profile
• Firmware acceleration/jerk too high

Got: Root cause identified with supporting evidence (measured temps, belt tension, visual inspection).

If fail: Root cause unclear? Use elimination method — fix most likely cause, re-test, repeat until resolved.

4. Apply First-Level Fixes

Implement immediate solutions for common issues:

Poor Bed Adhesion

Immediate fixes:

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 settings:

• First layer height: 0.2-0.3mm (thicker = better squish)
• First layer speed: 20mm/s (slower = better adhesion)
• Add brim: 8-10mm for small footprint parts
• Add raft: For very difficult materials (TPU, Nylon)

Got: First layer adheres complete. No lifting.

If fail: Check bed flatness with feeler gauge or mesh leveling. Warped bed needs glass/PEI sheet or mesh compensation.

Stringing

Temperature-first approach:

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 tuning:

# 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 remove easy by hand.

If fail: Check nozzle partial clog or wet filament — both cause oozing.

Layer Shifts

Mechanical 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 layer shifts in re-print with tightened belts, reduced speeds.

If fail: Check slicer-generated collisions (part cooling fan hits model) or electrical issues (stepper driver overheats).

Warping

Thermal management:

# 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:

• Add brim: 10-15mm for corners
• Add "mouse ears": 15mm diameter discs at sharp corners
• Chamfer bottom edges in model (45° × 1mm removes stress concentrator)

Got: Part stays flat. No corner lifting.

If fail: Material fundamentally unsuitable for printer (ABS on unenclosed printer). Switch to PETG or ASA.

Under-Extrusion

Quick fixes:

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 calibration:

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 or infill.

If fail: Check heat creep (cooling fan failure), worn extruder gear, or cracked extruder arm.

Over-Extrusion

Flow rate 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

Dimensional 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 dimensions, smooth surfaces, no bulging.

If fail: Re-calibrate e-steps (may be too high).

5. Verify Fix with Test Print

Confirm resolution before full print:

Test print selection:

• Adhesion issues: 20mm square × 5 layers (fast first layer test)
• Stringing: Stringing test model (dual towers with travels)
• Layer shifts: Tall thin test (stress mechanical system)
• Warping: Large flat surface (200mm × 200mm × 0.4mm)
• Extrusion: 20mm calibration cube (dimensional accuracy)

Got: Test print succeeds. Issue resolved.

If fail: Test fails? Issue not fully resolved or multiple issues present. Repeat diagnosis. Focus on remaining symptoms.

6. Document Solution

Record successful fix for future reference:

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 with root cause, solution for knowledge base.

If fail: Even unsuccessful troubleshooting attempts should log — avoid repeat failed solutions.

Checks

• Failure symptoms documented with photos, specific observations
• Issue classified using diagnostic reference table
• Root cause identified (mechanical, thermal, material, config)
• Appropriate fix applied based on root cause category
• Fix verified with test print before full print
• Solution documented in issue log with date, cause, resolution
• Environmental factors recorded (temp, humidity, drafts)
• Material condition checked (dry, contamination-free, stored proper)

Pitfalls

1. Change multiple variables: Adjust one parameter at a time. Else don't know what fixed it (or made worse)
2. Ignore wet filament: Hygroscopic materials (Nylon, TPU, PETG) absorb moisture — bubbling, stringing, poor adhesion. Always suspect wet filament first
3. Skip mechanical checks: Loose belts, worn components cause issues no slicer tuning fixes
4. Temperature from internet: Every printer/material combo unique. Always run own temperature tower
5. Over-tighten belts: Too tight = premature bearing wear. Aim for guitar string tension, not steel cable
6. Blame slicer: Slicer bugs rare. 95% of issues mechanical, thermal, or material-related
7. No clean nozzle: Partial clogs cause intermittent under-extrusion. Looks like flow/e-step issues
8. Assume bed level: Beds warp over time, springs compress, adjustments slip. Re-level weekly for reliable results
9. Wrong Z-offset: Most first layer failures = Z-offset too high (no squish) or too low (nozzle scrapes bed)
10. Environmental neglect: ABS/ASA in 15°C garage with drafts never prints well. Material needs stable warm env

See Also

• prepare-print-model: Ensure model prepared properly. Avoid printability issues
• select-print-material: Choose material appropriate for printer capabilities, environment
• Calibrate 3D Printer (future skill): E-steps, flow rate, temperature towers, PID tuning, bed mesh leveling
• Maintain 3D Printer (future skill): Belt tensioning, bearing lubrication, nozzle replacement, preventive maintenance