跳到主要内容

温度、加热与挤出报错

本页整理温度传感器、加热器、热床、挤出和断料检测相关报错。温度保护类报错应先确认硬件和温度曲线，不要通过关闭保护来绕过问题。

Error 'XXX mcu' shutdown: ADC out of range​

报错信息：ADC 超出量程范围，温度检测异常。

Loading...

报错原因：Klipper 检测到温度超过配置允许范围，常见于热敏电阻开路、短路、接线错误、热敏型号配置错误或引脚配置错误。

注意

临时放宽 min_temp 和 max_temp 只能用于排查，不能作为长期配置。确认问题后必须恢复到安全范围，避免温度保护失效。

排查顺序：

断电操作

检查热敏电阻、加热棒、热床、保险丝、SSR、MOS 管或电源相关线束前，请完全关闭打印机并断开电源供应，并等待热端和热床冷却。不要拆卸电源、触碰裸露电源端子或检查市电热床高压接线。

  1. 断电并等待冷却后，检查热敏电阻是否插牢，线材是否断裂或短路。
  2. 检查热敏型号和引脚配置是否与实际硬件一致。
  3. 必要时临时放宽温度范围用于确认读数变化，例如将 min_temp 改低、max_temp 改高。
  4. 找到并解决接线或配置问题后，立即恢复原来的安全温度限制。
  5. 保存并重启 Klipper。

相关配置参考：加热相关。

Heater not heating at expected rate​

报错信息：加热器没有按预期速度升温，日志中可能出现 Heater extruder not heating at expected rate 或 Heater heater_bed not heating at expected rate。

Loading...

常见原因：

  • 加热棒、热床或 SSR / MOS 管输出异常。
  • 热敏电阻接触不良、线材半断或读数跳变。
  • 风扇直吹热端、热床或加热区域，导致升温过慢。
  • 热床功率不足，或 max_power 限制过低。
  • PID 参数不合适，温度接近目标时波动过大。

解决方法：

断电操作

检查加热器、热敏电阻、热床、保险丝、SSR、MOS 管或电源相关线束前，请完全关闭打印机并断开电源供应，并等待热端和热床冷却。不要拆卸电源、触碰裸露电源端子或检查市电热床高压接线。

  1. 断电并等待冷却后，检查加热器和热敏电阻接线是否牢固。
  2. 观察温度曲线，确认升温是否连续、是否有异常跳变。
  3. 检查是否有风扇直吹热端或热床。
  4. 对于 SSR、MOS 管、电源功率或高压热床问题，普通用户应优先通过替换成品模块、检查网页温度曲线和联系售后来排查，不要自行拆解或进行电气检测。
  5. 确认硬件正常后重新执行 PID 校准。
  6. 如果确认只是大尺寸热床或特殊结构导致升温慢，可参考 verify_heater 优化。

相关配置参考：加热相关、M109 优化。

温度读数异常（温度显示 0°C 或持续跳变）​

报错信息：温度显示为 0°C、负数或读数持续大幅跳变（±10°C 以上）。

常见原因：

  • 热敏电阻断线（显示 0 或极低值）。
  • 热敏电阻短路（显示极高值或触发 ADC out of range）。
  • sensor_type 配置与实际热敏型号不匹配。
  • PT100 传感器缺少 pullup_resistor 配置。
  • 热电偶信号干扰，需要 filter_length 或 thermocouple_max_error 配置。
  • ADC 噪声干扰。

解决方法：

  1. 执行 QUERY_ADC SENSOR=extruder_temp 查看原始 ADC 读数。
  2. 执行 M105 查看当前温度读数。
  3. 确认 sensor_type 与硬件一致，常见为 NTC 100K beta 3950、PT100、MAX31865 等。
  4. PT100 传感器需检查 sensor_pin、rtd_reference_r、rtd_num_of_wires。
  5. 热电偶可检查 thermocouple_max_error，ADC 噪声大时可检查 filter_length。

相关配置参考：加热相关。

MCU shutdown: Verify heater extruder/heater_bed​

报错信息：MCU 'mcu' shutdown: Verify heater extruder 或 Verify heater heater_bed。

报错原因：Klipper 内置 verify_heater 安全检查检测到加热器温度变化不符合预期，可能是加热器输出异常、热敏读数不可信、SSR 响应延迟或大功率热床升温曲线与默认检测参数不匹配。

注意

不要为了绕过报错而直接关闭 verify_heater 功能或将其阈值设置为极不合理的值。这会移除 Klipper 对加热器和热敏的最后一层安全校验。

常见场景：

  • 大尺寸热床 + SSR：SSR 开关响应、热床热容和默认 heating_gain 不匹配。
  • 更换加热棒、热床或热敏后，新硬件的热特性与旧 PID 和校验参数不兼容。
  • 风扇直吹热端，环境气流导致温度波动超出 max_error 范围。
  • 热敏接触不良或安装松动，读数断续跳变。
  • 供电电压不稳或电源功率不足。

排查方法：

断电操作

检查加热器、热敏、SSR、MOS 管、保险丝或电源相关线束前，请完全关闭打印机并断开电源供应，并等待热端和热床冷却。不要拆卸电源、触碰裸露端子或检查市电热床高压接线。

  1. 先断电检查热敏是否插牢、加热器接线是否牢固。
  2. 观察 klippy.log 中 shutdown 前的温度曲线。如果曲线稳定上升且不跳变，更可能是参数太敏感；如果断续跳变、归零或飙升，则优先处理硬件问题。
  3. 检查 [verify_heater extruder] 或 [verify_heater heater_bed] 配置段。
  4. 确认硬件正常后重新执行 PID 校准，再观察是否仍误触发。
  5. 更详细的参数说明和调优示例参考 verify_heater 优化。

HOST temperature above maximum temperature​

报错信息：HOST temperature xx above maximum temperature 或 MCU temperature not supported on xxx。

常见原因：

  • 上位机 CPU 温度过高，超过 [temperature_host] 中的 max_temp。
  • 主板 MCU 内置温度传感器不受当前固件/芯片支持。
  • 上位机散热不足，外壳密闭、风扇停转或环境温度过高。

解决方法：

  1. 检查上位机散热片、风扇和外壳通风。
  2. 使用 vcgencmd measure_temp、sensors 或系统监控查看 CPU 温度。
  3. 若只是阈值设置过低，适当调整 [temperature_host] max_temp，但不要关闭温度保护。
  4. 如果报 MCU temperature not supported，删除或注释不受支持 MCU 的 [temperature_mcu] 配置。

相关配置参考：风扇参考配置。

挤出问题​

Extrude below minimum temp​

报错信息：喷嘴温度低于允许挤出的最低温度，日志中可能出现 Extrude below minimum temp 或 Extruder not hot enough。

解决方法：

  1. 执行挤出前确认喷嘴已达到耗材所需温度。
  2. 检查起始 G-code、M600、PAUSE、RESUME 等宏中是否有等待温度命令。
  3. 在需要等待温度的位置使用 M109 或 Klipper 等效等待命令。
  4. 检查热敏电阻和温度曲线，确认温度读数稳定。
  5. 不建议为了绕过报错长期降低 min_extrude_temp。

相关配置参考：M109 优化、宏介绍。

Extrude only move too long​

报错信息：Extrude only move too long (xxmm vs xxmm)。

解决方法：

  1. 检查切片机回抽长度，Bowden 远程挤出也不要盲目设置过大。
  2. 将换料或装料宏中的长距离挤出拆成多段。
  3. 检查宏中是否正确使用 M82 / M83 和 G92 E0。
  4. 如确实需要长距离纯挤出，可在 [extruder] 中适当增大 max_extrude_only_distance。

相关配置参考：挤出机参考配置、宏介绍。

Move exceeds maximum extrusion​

报错信息：Move exceeds maximum extrusion (xxmm^2 vs xxmm^2)。

解决方法：

  1. 检查切片机耗材直径、喷嘴直径、挤出倍率和线宽是否异常。
  2. 检查起始/暂停/恢复宏中的挤出模式和 G92 E0。
  3. 检查 [extruder] 中 nozzle_diameter、filament_diameter 或 max_extrude_cross_section。
  4. 不建议直接大幅提高 max_extrude_cross_section；应先确认 G-code 和切片参数正常。

相关配置参考：挤出机参考配置、机器校准。

Extrude when no extruder present / Extruder not configured​

报错信息：Extrude when no extruder present、Extruder not configured 或 Active extruder does not have a stepper。

解决方法：

  1. 确认主挤出机配置段名称为 [extruder]。
  2. 多挤出或同步挤出场景，检查 [extruder_stepper] 和 SYNC_EXTRUDER_MOTION。
  3. 检查宏中的 ACTIVATE_EXTRUDER、T0/T1 或自定义切换命令是否指向真实配置段。

相关配置参考：挤出机参考配置。

断料检测与 M600 换料报错​

报错信息：Filament sensor: runout detected、M600 换料宏执行后打印中断无法恢复、断料检测开关始终处于触发或未触发状态。

解决方法：

断电操作

检查、拔插或更换断料检测传感器线束前，请完全关闭打印机并断开电源供应。不要在通电状态下插拔传感器模块或整理接口线序。

  1. 执行 QUERY_FILAMENT_SENSOR SENSOR=<传感器名>，确认插入耗材时状态为 open（或 not triggered），拔出后状态变化。
  2. 如果状态始终不变，断电后检查传感器接线、switch_pin 和上拉配置。
  3. 如果打印过程中频繁误触发，检查线束是否在拖链中过度弯曲或被运动轴拉扯。
  4. 检查 M600 宏逻辑，确认暂停、回抽、抬升和恢复流程正常。
  5. 多挤出机场景下，确认 ACTIVATE_EXTRUDER 和断料检测逻辑作用的是同一个挤出机。

相关配置参考：宏介绍、断料检测参考配置。

Loading...