---

name: troubleshoot-print-issues description: > Diagnosticar y corregir fallos comunes de impresión 3D mediante análisis sistemático de síntomas. Cubre adhesión, hilos, desplazamientos de capa, deformación y problemas de sub/sobre-extrusión. Usar cuando una impresión falla durante la primera capa o a mitad de proceso, las impresiones terminadas tienen defectos de calidad (hilos, gotas, huecos), ocurren problemas de precisión dimensional (deformación, pie de elefante), falla la adhesión entre capas, o cambios de material o hardware nuevos causan resultados inconsistentes. 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 locale: es source_locale: en source_commit: 33b561c9 translator: claude translation_date: "2026-03-17"

Troubleshoot Print Issues

Diagnosticar y corregir fallos comunes de impresión 3D usando análisis sistemático de síntomas. Esta habilidad cubre los problemas más frecuentes de FDM y SLA: mala adhesión a la cama, hilos, desplazamientos de capa, deformación, sub-extrusión, sobre-extrusión y defectos de calidad de impresión. Utiliza un enfoque estructurado de identificación de síntomas, análisis de causa raíz y correcciones iterativas.

Cuándo Usar

• La impresión falla durante la primera capa o a mitad del proceso
• Las impresiones terminadas tienen defectos de calidad (hilos, gotas, huecos, superficies rugosas)
• Problemas de precisión dimensional (sobredimensionado/subdimensionado, deformación, pie de elefante)
• Problemas de adhesión entre capas (delaminación, separación)
• La eliminación de soportes deja daños o los soportes fallan durante la impresión
• Las impresiones se ven diferentes a la vista previa del slicer
• El material se comporta de manera inconsistente entre impresiones
• Nuevo material, impresora o condiciones ambientales causan problemas

Entradas

• Requerido: failure_description — Qué salió mal (primera capa fallida, hilos, deformación, etc.)
• Requerido: failure_timing — Cuándo ocurre el problema (primera capa, mitad de impresión, altura específica, capas superiores)
• Requerido: material — Tipo de filamento/resina, marca, antigüedad, condiciones de almacenamiento
• Requerido: printer — Marca/modelo, tamaño de boquilla, tipo de cama, cerramiento
• Opcional: recent_changes — Nuevo material, configuraciones del slicer, modificaciones de hardware, entorno
• Opcional: print_history — ¿Este modelo usualmente funciona? ¿Este material funcionó antes?

Procedimiento

1. Recopilar Síntomas de Fallo

Documentar síntomas observables con especificidad:

Inspección visual:

• Tomar fotos del fallo (general, primer plano, defecto específico)
• Notar la ubicación del fallo (primera capa, altura específica, superficie superior)
• Describir el tipo de defecto: huecos, gotas, hilos, desplazamientos, grietas

Datos ambientales:

• Temperatura ambiente durante la impresión
• Nivel de humedad
• Corrientes de aire o aire acondicionado afectando la impresora
• Hora del día (cambios de temperatura)

Parámetros de impresión:

# 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

Esperado: Descripción detallada de síntomas con fotos, parámetros y contexto ambiental.

En caso de fallo: Si los síntomas no son claros, imprimir una prueba de calibración (torre de temperatura, prueba de hilos o benchy) para reproducir y observar el fallo sistemáticamente.

2. Clasificar el Problema por Patrón de Síntomas

Emparejar los síntomas observados con modos de fallo comunes:

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

Esperado: Fallo clasificado en 1-3 categorías más probables.

En caso de fallo: Si los síntomas coinciden con múltiples categorías, priorizar según el momento del fallo (problemas de primera capa primero, luego mitad de impresión, luego superficie superior).

3. Realizar Análisis de Causa Raíz

Investigar la causa subyacente, no solo los síntomas:

Técnica de los 5 por qué:

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

Causas raíz comunes por categoría:

Mecánicas:

• Correas, poleas o tornillos de ajuste flojos
• Rodamientos lineales o varillas desgastados/sucios
• Eje Z atascado o desalineado
• Engranaje del extrusor desgastado o saltando

Térmicas:

• Deriva o fallo del sensor de temperatura
• Potencia/aislamiento insuficiente de la cama caliente
• Enfriamiento insuficiente de la pieza
• Fluctuaciones de temperatura ambiental

Material:

• Filamento húmedo (materiales higroscópicos)
• Material viejo/degradado
• Filamento contaminado (polvo, aceites)
• Material incorrecto para la aplicación

Configuración:

• Calibración incorrecta de e-steps
• Multiplicador de flujo incorrecto
• Error del slicer o perfil equivocado
• Aceleración/jerk del firmware demasiado alto

Esperado: Causa raíz identificada con evidencia de soporte (temperaturas medidas, tensión de correas, inspección visual).

En caso de fallo: Si la causa raíz no es clara, usar el método de eliminación: corregir la causa más probable, re-probar, repetir hasta resolver.

4. Aplicar Correcciones de Primer Nivel

Implementar soluciones inmediatas para problemas comunes:

Mala Adhesión a la Cama

Correcciones inmediatas:

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

Configuraciones del slicer:

• Altura de primera capa: 0.2-0.3mm (más gruesa = mejor aplastamiento)
• Velocidad de primera capa: 20mm/s (más lenta = mejor adhesión)
• Agregar brim: 8-10mm para piezas con huella pequeña
• Agregar raft: Para materiales muy difíciles (TPU, Nylon)

Esperado: La primera capa se adhiere completamente sin levantamiento.

En caso de fallo: Verificar la planitud de la cama con galga de espesores o nivelación por malla; una cama deformada requiere placa de vidrio/PEI o compensación por malla.

Hilos (Stringing)

Enfoque de temperatura primero:

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

Ajuste de retracción:

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

Esperado: Hilos mínimos, hilos delgados fácilmente removibles a mano.

En caso de fallo: Verificar obstrucción parcial de la boquilla o filamento húmedo (ambos causan goteo).

Desplazamientos de Capa

Verificaciones mecánicas:

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

Reducción de velocidad:

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

Esperado: Sin desplazamientos de capa en la reimpresión con correas tensadas y velocidades reducidas.

En caso de fallo: Verificar colisiones generadas por el slicer (ventilador de enfriamiento de pieza golpeando el modelo) o problemas eléctricos (driver del motor paso a paso sobrecalentándose).

Deformación (Warping)

Gestión térmica:

# 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

Mejora de adhesión:

• Agregar brim: 10-15mm para esquinas
• Agregar "orejas de ratón": discos de 15mm de diámetro en esquinas agudas
• Achaflanar bordes inferiores en el modelo (45° × 1mm elimina el concentrador de esfuerzo)

Esperado: La pieza permanece plana sin levantamiento de esquinas.

En caso de fallo: Material fundamentalmente inadecuado para la impresora (ABS en impresora sin cerramiento) — cambiar a PETG o ASA.

Sub-Extrusión

Correcciones rápidas:

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%

Calibración de e-steps:

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)

Esperado: Extrusión consistente sin huecos en perímetros o relleno.

En caso de fallo: Verificar infiltración de calor (fallo del ventilador de enfriamiento), engranaje del extrusor desgastado o brazo del extrusor agrietado.

Sobre-Extrusión

Reducción de tasa de flujo:

# 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

Prueba de precisión dimensional: 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

Esperado: Dimensiones precisas, superficies lisas, sin abultamiento.

En caso de fallo: Recalibrar e-steps (pueden estar configurados demasiado alto).

5. Verificar la Corrección con Impresión de Prueba

Confirmar la resolución antes de intentar la impresión completa:

Selección de impresión de prueba:

• Problemas de adhesión: Cuadrado de 20mm × 5 capas (prueba rápida de primera capa)
• Hilos: Modelo de prueba de hilos (torres dobles con desplazamientos)
• Desplazamientos de capa: Prueba alta y delgada (estrés del sistema mecánico)
• Deformación: Superficie plana grande (200mm × 200mm × 0.4mm)
• Extrusión: Cubo de calibración de 20mm (precisión dimensional)

Esperado: La impresión de prueba tiene éxito con el problema resuelto.

En caso de fallo: Si la prueba falla, el problema no está completamente resuelto o hay múltiples problemas presentes — repetir el diagnóstico enfocándose en los síntomas restantes.

6. Documentar la Solución

Registrar la corrección exitosa para referencia futura:

Plantilla de registro de problemas:

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"

Esperado: Problema documentado con causa raíz y solución para la base de conocimiento.

En caso de fallo: Incluso los intentos de solución de problemas fallidos deben registrarse para evitar repetir soluciones que no funcionaron.

Validación

• Síntomas de fallo documentados con fotos y observaciones específicas
• Problema clasificado usando la tabla de referencia diagnóstica
• Causa raíz identificada (mecánica, térmica, material o configuración)
• Corrección apropiada aplicada según la categoría de causa raíz
• Corrección verificada con impresión de prueba antes de intentar la impresión completa
• Solución documentada en el registro de problemas con fecha, causa y resolución
• Factores ambientales registrados (temperatura, humedad, corrientes de aire)
• Condición del material verificada (seco, libre de contaminación, almacenado correctamente)

Errores Comunes

1. Cambiar múltiples variables: Ajustar un parámetro a la vez; de lo contrario no sabrás qué lo arregló (o lo empeoró)
2. Ignorar filamento húmedo: Los materiales higroscópicos (Nylon, TPU, PETG) absorben humedad causando burbujas, hilos, mala adhesión — siempre sospechar del filamento húmedo primero
3. Saltarse verificaciones mecánicas: Correas flojas y componentes desgastados causan problemas que ningún ajuste del slicer puede arreglar
4. Temperatura de internet: Cada combinación impresora/material es única — siempre ejecutar tu propia torre de temperatura
5. Sobre-tensar correas: Demasiado tensas = desgaste prematuro de rodamientos; apuntar a tensión de cuerda de guitarra, no de cable de acero
6. Culpar al slicer: Los errores del slicer son raros; 95% de los problemas son mecánicos, térmicos o relacionados con el material
7. No limpiar la boquilla: Obstrucciones parciales causan sub-extrusión intermitente que parece problemas de flujo/e-steps
8. Asumir que la cama está nivelada: Las camas se deforman con el tiempo, los resortes se comprimen y los ajustes se deslizan — re-nivelar semanalmente para resultados confiables
9. Z-offset incorrecto: La mayoría de fallos de primera capa son Z-offset demasiado alto (insuficiente aplastamiento) o demasiado bajo (boquilla raspando la cama)
10. Descuido ambiental: ABS/ASA en garaje a 15°C con corrientes de aire nunca imprimirá bien — el material requiere un ambiente cálido y estable

Habilidades Relacionadas

• prepare-print-model: Asegurar que el modelo esté correctamente preparado para evitar problemas de imprimibilidad
• select-print-material: Elegir material apropiado para las capacidades de la impresora y el entorno
• Calibrate 3D Printer (habilidad futura): E-steps, tasa de flujo, torres de temperatura, ajuste PID y nivelación por malla de la cama
• Maintain 3D Printer (habilidad futura): Tensado de correas, lubricación de rodamientos, reemplazo de boquilla y mantenimiento preventivo