Voron Layer Shifting — Causes, Diagnosis, and Fixes

故障排查 Mechanical 校准

Layer shifting is one of the most frustrating problems on a Voron printer. You come back to a print that was running perfectly, only to find that somewhere around layer 137, the entire print shifted 3mm to the left — or the Y-axis decided to walk the part clean off the bed. The root cause is almost always mechanical or electrical, not a slicer setting. This guide walks you through every possible cause, ordered by likelihood, with specific diagnosis steps and Klipper-config-level fixes. 最后更新：2025 年 5 月。

在深入之前：层移是指步进电机失去位置精度——要么是丢步（转子物理上错过一个磁步），要么是皮带在同步轮齿上打滑。结果是某个或两个轴出现突然的永久性偏移，并持续到打印结束。理解你看到的偏移类型是诊断的第一步。

识别你的层移类型

层移可分为不同类别。仔细观察偏移模式——它会告诉你问题所在：

仅 X 轴，方向一致： Always shifts left or always shifts right. This points to a mechanical issue on the X gantry — loose belt, binding rail, or pulley alignment problem on that specific axis.
仅 Y 轴，方向一致： Similarly, this isolates the issue to the Y-axis mechanics. On V2.4, this is the most common shift axis due to belt length and gantry mass.
X 和 Y 轴随机移位： Electrical. The most common cause is stepper driver 电流下降 or overheating. When both axes fail simultaneously, the power supply or driver board is the common denominator.
随时间推移恶化的移位： Thermal. As the chamber heats up, drivers overheat, belts change tension, or connectors expand. If the print fails at hour 6 but looks fine at hour 1, this is your category.
仅在高加速度下出现移位： Either acceleration is too high for the available torque, or the belts are too loose to transmit that torque without skipping.

拍摄失败打印件的照片或视频，记录偏移方向、发生层数（大致打印时间），以及是在快速移动还是慢速轮廓段发生的。仅凭这些信息就能解决一半案例。

诊断检查清单（按可能性排序）

按顺序检查此清单。不要跳过任何步骤。据估计，90%的Voron层移问题在步骤3之前就能被捕获。

皮带张力检查。 Measure both X and Y belts with a frequency app (Spectroid or Gates app). Loose belts are the #1 cause of layer shifts on all Voron models. Target: X 90-110 Hz, Y 80-100 Hz for V2.4 300mm. See our belt tension guide for model-specific targets.
滑轮对齐和皮带摩擦。 Spin the pulleys by hand. Is the belt riding against the pulley flange? Is the belt centered on the pulley teeth? A belt rubbing against a printed part, extrusion edge, or zip tie will cause intermittent binding that manifests as shifts.
步进驱动电流 / Vref。 If belts are fine, the next most common cause is insufficient current. TMC2209 drivers in stealthChop mode have a maximum RMS current of ~1.2A. Running above that causes thermal shutdown — the driver stops sending pulses, the motor loses position, and you get a shift. Check your Klipper config for run_current.
加速度过高。 Even with correct current, there's a torque limit. If you're running 20,000 mm/s² on a V2.4 350mm with stock motors, you will get shifts. Reduce acceleration by 50% as a test.
机械卡滞。 Overtightened MGN9/MGN12 rails, misaligned gantry, flat-spotted wheels on V2.4, or a warped extrusion. Move each axis by hand with the motors disabled — it should move freely with no tight spots.
电气连接。 Loose JST connectors on the stepper motor wires, cold solder joints at the motor pins, or a loose connector at the mainboard. Vibration over hours of printing can wiggle a connector just enough to cause intermittent contact loss.
电源电压下降。 Under heavy load (all axes moving + bed heating + hotend), the PSU voltage can sag below the driver's minimum operating voltage. Measure 24V rail at the mainboard during a print with a multimeter.

皮带张力：首要原因

松动的皮带无法将电机扭矩传递到龙门架，而不会在同步轮上打滑。在Voron打印机上，GT2皮带配合20齿同步轮，电机每转一圈移动40mm。如果皮带松到足以跳过一齿（2mm齿距），就会产生2mm的层移。跳过两齿则达到4mm。

诊断： Pluck each belt and measure frequency with a smartphone spectrum analyzer app. If the frequency is more than 15 Hz below the target for your model, the belt is loose enough to cause shifts under load.

Fix: Re-tension to the correct frequency. After tensioning, run a high-acceleration test: print a 20mm cube at 10,000 mm/s² acceleration. If you see shifting, the belt is still too loose or there's a secondary cause.

步进驱动电流与Vref设置

Each stepper driver has a maximum current rating. The TMC2209 datasheet specifies a maximum RMS current of 1.2A in stealthChop2 mode and 2.0A in spreadCycle mode with adequate heatsinking. Voron stock configurations typically set run_current: 0.8 for X/Y motors — this is conservative and safe, but some users increase it for more torque.

步进电流计算指南： If you're using standalone drivers (non-UART) with Vref pots, use this formula:

RMS current = Vref / (2.5 × Rsense)

Example: Rsense = 0.110Ω, Vref = 1.0V
RMS = 1.0 / (2.5 × 0.110) = 1.0 / 0.275 = 3.64A
MRC (maximum = 2.0A RMS for TMC2209) → OVER LIMIT

Correct: Vref = 0.55V
RMS = 0.55 / 0.275 = 2.0A → At rated limit

For Klipper UART control: run_current = 0.8A (conservative) to 1.2A (aggressive)

在 Klipper 配置中修复：

[tmc2209 stepper_x]
uart_pin: PA1
run_current: 0.900
hold_current: 0.500
stealthchop_threshold: 0
interpolate: True
sense_resistor: 0.110  # Check your board's Rsense value

If you're getting shifts specifically on long prints (6+ hours), the issue may be current droop. TMC2209 drivers in stealthChop mode reduce current at low motor speeds. Over a long print, the driver temperature rises, internal resistance changes, and the effective current drops below the threshold needed for holding torque. Fix: set stealthchop_threshold: 0 to force spreadCycle mode (higher torque, more noise), or add a heatsink and fan to the driver cooling.

加速度与扭矩极限

每个步进电机都有扭矩曲线——扭矩随速度增加而下降。如果加速度过快，导致电机在移动过程中任何时刻的需求扭矩超过可用扭矩，转子将失去同步，从而产生偏移。

Voron打印机（原装电机，24V，0.8A运行电流）的安全加速度限制：

V2.4 250mm：X轴8,000-10,000 mm/s²，Y轴6,000-8,000 mm/s²
V2.4 300mm：X轴6,000-8,000 mm/s²，Y轴5,000-7,000 mm/s²
V2.4 350mm：X轴5,000-7,000 mm/s²，Y轴4,000-6,000 mm/s²
Trident 250mm：X轴10,000-15,000 mm/s²，Y轴10,000-15,000 mm/s²
Trident 300mm: 8,000-12,000 mm/s² X轴, 8,000-12,000 mm/s² Y轴
V0.2: 双轴均为12,000-18,000 mm/s²

Fix: Reduce max_accel and max_accel_to_decel in your Klipper config by 30-50% as a test. If the shifts stop, gradually increase until you find the limit. Also check max_velocity — running 500mm/s with insufficient acceleration distance can cause the motor to miss steps during deceleration.

机械卡滞

卡滞会导致间歇性阻力尖峰，超过电机保持扭矩。Voron 打印机常见卡滞来源：

MGN9/MGN12直线导轨过紧： The carriage blocks should slide with smooth, light resistance. If they're tight enough that you feel a catch or stutter when moving by hand, the rail bolts are over-torqued. Back off all bolts by 1/8 turn and retest.
龙门架未对齐（V2.4）： The Z belts pull the gantry up. If the four Z motors are out of sync, the gantry racks and the X/Y belts have to work against the diagonal binding force. Run QUAD_GANTRY_LEVEL and re-check.
V2.4聚碳酸酯轮出现扁平点： If the printer sits for weeks without moving, the wheels develop flat spots at the contact points. These cause a thump-thump-thump on every rotation, and during fast moves, that thump can be enough to skip a belt tooth. Replace the wheels or rotate them to a fresh surface.
Trident Z轴卡滞： The Trident's three Z lead screws must be precisely aligned with the Z rail blocks. If the build plate is misaligned (not parallel to the gantry), the Z motors fight each other, causing skipped steps on the Z axis — which manifests as inconsistent layer height, not horizontal shifts, but severe cases can cause the gantry to bind and create X/Y shifts.

V2.4 专属：Y轴皮带长度与质量相关问题

V2.4 具有独特的 Y 轴皮带配置：皮带横跨打印机全长（从前惰轮到后电机），工具头和龙门架固定在皮带上。在 V2.4 350mm 机型上，Y 皮带环长度可超过 1.2 米。这种长皮带跨度存在两个问题：

弹性拉伸： Under high acceleration, the belt stretches elastically. The motor rotates, but the toolhead doesn't move immediately — there's a spring effect. At the deceleration phase, the belt recoils and can cause the motor to lose synchronization.
质量： The V2.4 gantry (toolhead + X extrusion + XY joints) weighs approximately 1.2-1.8 kg depending on configuration. Moving that mass on a long belt loop requires significant torque. Combined with elastic stretch, the Y axis is the most common shift axis on V2.4.

V2.4专用修复： Reduce Y acceleration to 60% of X acceleration. Use [[accelerometer]] input shaper tuning to minimize resonance — resonance amplifies the belt stretch effect. Consider upgrading to wider belts (9mm GT2) or using fiber-reinforced belts (Gates PowerGrip with carbon cord).

Trident 专属：Z轴电机卡滞

The Trident uses three independently-driven Z lead screws. If the build plate isn't perfectly trammed (parallel to the gantry), the three Z motors fight each other. The software tries to compensate (Z_TILT_ADJUST), but if the mechanical misalignment exceeds the lead screw's ability to adjust, one motor will bind.

症状： You'll see layer shifts predominantly on the X axis, but only after the Z has moved through a specific height range. The shift may be intermittent — it happens at the same Z height every time, because that's where the lead screw nut reaches its binding point.

诊断： Home the printer, then manually drive Z up and down in 50mm increments. At each height, measure the distance from the gantry to the build plate at all three corners. A difference greater than 0.5mm indicates binding. Also listen for grinding or clicking sounds from the Z motors during Z_TILT_ADJUST.

Fix: Loosen the Z motor mounts, lead screw couplers, and Z rail brackets. Run Z_TILT_ADJUST with the screws loose, then re-tighten everything while the motors are holding position. This auto-aligns the lead screws to the build plate position. After tightening, run Z_TILT_ADJUST again and check that all three corners report within 0.01mm.

电气原因：连接与电源

数小时打印产生的振动会逐渐松动连接器。最常见的电气故障点：

步进电机上的JST-XH连接器： These are the small white connectors on Voron stepper motors. After 500+ hours, the crimp contacts can loosen. Gently tug each wire — if any pulls out, re-crimp or replace the connector.
电机引脚处的焊点： Some Voron motors have soldered wire-to-pin connections inside the motor housing. Thermal cycling (heating and cooling) causes micro-cracks. If you've checked everything else and still get shifts, desolder and re-solder these joints.
主板连接器插头： The Dupont or JST headers on the mainboard can develop poor contact. If the connector body doesn't click firmly into place, replace it. A zip tie securing the connector to the board can prevent vibration loosening.
电源电压下降： Under max load — bed heating at 110°C, hotend at 260°C, and all axes moving simultaneously — a 350W Meanwell PSU can sag from 24V to 22V or lower. TMC2209 drivers have a brownout threshold around 8V, but torque drops significantly below 20V. Measure the 24V rail at the mainboard terminals during a high-speed print. If you see below 23V, consider a separate PSU for the bed heater or a higher-rated supply.

快速最终检查清单

在放弃并更换零件之前，运行此 5 分钟测试序列：

拨动同步带并测量频率——确认在目标范围内
检查所有同步轮紧定螺丝——是否牢固锁紧在电机D型轴上？
电机断电后手动移动X/Y轴——是否存在卡滞点？
Run MOTOR_CURRENT_QUERY in Klipper — verify run_current is being applied
将加速度降至5,000 mm/s²并打印校准立方体——若无偏移，则问题与扭矩或同步带相关

Voron 上的层移几乎从不是切片问题，也几乎从不是谜团。它是皮带、电流或卡滞的问题。有条不紊地检查此清单，您将在一小时内找到原因。