How to Troubleshoot CNC Machines
A working method for operators and engineers who need the spindle turning again. We cover the symptoms that show up most often, what usually causes them, and which checks you can run without pulling the machine apart. You will also see when a fault is a shop-floor fix and when it is a service call.
In this article
- 1
- 2
- 3
- 4
- 5
- 6
How to Troubleshoot CNC Machines: Symptom, Cause, Action
Read the symptom column first, then confirm the cause before touching the machine. One symptom can have several causes, so work top to bottom.
| Symptom | Likely cause | First action |
|---|---|---|
| Over-travel alarm on one axis | Work offset or tool length set wrong | Re-check offsets against the setup sheet |
| Servo fault on Z at startup | Drive overload or encoder cable damage | Power down, inspect cable, check load current |
| Tool changer stops mid-arm | Misaligned arm or dirty cam | Hand-jog to home, clean and re-teach position |
| Spindle stalls under cut | Feed or depth too high for the tool | Cut feed 30–50%, reduce axial depth |
| Surface finish drifts rough | Tool wear or loose insert | Index or replace insert, re-check runout |
| Dimensions creep over a run | Thermal growth in spindle and ballscrew | Let machine idle 20–30 min, re-check first part |
| Coolant flow drops | Clogged nozzle or low tank level | Flush nozzle, top up, check pump strainer |
| Chatter on thin walls | Weak workholding or long tool overhang | Shorten overhang, add support, drop rpm 10–20% |
Fix what you can measure, escalate what you cannot
Most CNC faults are setup, tooling or cutting data, and you can find them with a log, a dial indicator and one test cut. Once the fault points inside a drive, a spindle or the control, stop and call a technician with the data in hand.
Triage before you touch anything
Most machine stops give you data before you open a panel. Read the alarm number, the axis name and the time stamp on the control. Write them down. An alarm that fires at the same point in every cycle points to the program or the fixture. An alarm that fires at random points to a drive, a cable or a sensor.
Ask the operator what changed. A new tool, a new program, a heavier cut, a fixture re-clamped by hand. Around 70% of the faults we get called out for trace back to a setup change made in the previous shift, not to a failed component.
Keep the machine in the state it failed in. Do not clear the alarm and re-home everything before you have read the logs. Once you reset, the servo fault history on many controls is gone. If you need a fresh run to reproduce the fault, run it in single block with rapid override at 25%.
Then decide which of three buckets the fault belongs to: program and offsets, mechanical and tooling, or electrical and control. The first bucket you can fix in minutes. The second takes an hour and some tools. The third usually needs a service technician and a spare part.
- 1Log the alarmNumber, axis, cycle position, time.
- 2Ask what changedTool, program, fixture or material.
- 3Do not reset firstYou lose the fault history.
- 4Pick a bucketProgram, mechanical, or electrical.
Faults that show up most often, and what causes them
Over-travel and soft-limit alarms are almost always setup errors. A work offset entered in the wrong register, a tool length measured against the wrong reference, or a fixture that sits 5 mm lower than last time. Re-measure, do not guess. On a machine with ±0.005 mm capability, a 0.05 mm offset error is enough to scrap a tight-tolerance part.
Servo and spindle faults split into two groups. Overload faults come from cutting conditions: too much radial engagement, a dull tool, chips packed in the flutes. Feedback faults come from encoders and cables: a damaged shield, coolant ingress at a connector, a loose ground. Overload clears when you change the cut. Feedback faults come back at the same axis position every time.
Tool changer faults are mechanical and repeatable. The arm stops short, the spindle does not orient, or the tool does not release. Check the orientation sensor and the drawbar first. Then check the cam and the Geneva drive for chips or dried grease. A changer that has run 200,000 cycles without a cam service will start missing positions.
Coolant and chip problems look minor and cost the most. Low flow raises cutting temperature, which changes dimensions on aluminium and stainless. A clogged nozzle on one side of a deep pocket means the tool recuts chips. That shows up as sudden tool breakage, not as a gradual wear curve.
- 1Offsets cause travel alarmsRe-measure, do not adjust by feel.
- 2Overload vs feedbackRepeatable position = feedback fault.
- 3Changer faults are mechanicalSensor, drawbar, cam, grease.
- 4Coolant is a quality toolLow flow shows up as broken tools.
When the machine runs fine but parts drift out of tolerance
A machine can hold position and still produce bad parts. If the first part is good and part twenty is out, the problem is thermal. Spindle and ballscrew growth on a machine running 12,000 rpm can move a dimension by 0.02–0.04 mm over the first two hours. Warm the machine up, then set the offset, then run.
If every part is the same amount out, it is an offset or a tool. Measure the tool again on the presetter and check runout at the holder. Runout over 0.01 mm on a small end mill changes both the finish and the effective diameter. That is enough to push a ±0.005 mm bore out of spec.
If the size varies within one part, it is the fixture. Thin walls move when the clamps release. Deep pockets move when the material relieves. Check the part with the clamps still on, then after release, and compare. If the two readings differ, the setup is fighting the part.
Surface finish problems follow a separate path. Ra 0.8–1.6 μm is a normal machined finish. If you need Ra 0.2–0.8 μm, the tool, the rpm and the coolant all have to be right. Chatter marks mean the system is not stiff enough: shorten tool overhang, reduce rpm by 10–20%, or add a support under the part.
- 1Drift over a runThermal growth. Warm up first.
- 2Same error every partOffset or tool runout.
- 3Varies within a partWorkholding or material relief.
- 4Chatter marksStiffness and rpm, not feed alone.
Checks that stop the next breakdown
Daily checks take ten minutes and catch most of what would become an unplanned stop. Look at the coolant level and flow, the air pressure at the machine, the way-lube level, and the condition of the wipers. Wipers that are worn let chips under the covers, and chips under the covers wear the linear guides.
Weekly checks are about the spindles and the changer. Check spindle taper for fretting or chips, check tool holder tapers for wear, and clean the changer cam. On a machine that runs two shifts, a taper that is not cleaned will pull a tool off-center and you will see the result in the surface finish before you see it in the size.
Monthly checks are about accuracy. Run a ballbar or a test cut, check backlash on each axis, and verify the level of the machine. A machine that has settled by 0.02 mm per meter will still cut, but it will cut a taper. On parts with a 4,000 mm envelope, that error compounds across the length.
Keep a fault log. Machine, date, alarm, action, and whether the fault returned. After six months you will see patterns that no single shift can see, and you will know which spare parts to keep on the shelf.
- 1DailyCoolant, air, lube, wipers.
- 2WeeklyTapers, holders, changer cam.
- 3MonthlyBacklash, level, test cut.
- 4AlwaysKeep a written fault log.
Step-by-step: how to troubleshoot CNC machines on the floor
Work in this order. Each step removes a class of causes, so you are not chasing two problems at once.
- 1Capture the alarm and the stateRecord the alarm number, axis, cycle position and time. Photograph the screen. Do not clear the alarm until the log is written down.
- 2Confirm the program and offsetsCompare the active work offset and tool length against the setup sheet. Re-measure the tool if the number is more than 0.02 mm from the sheet. Re-run in single block at 25% rapid.
- 3Check the cut, not the machineReduce feed by 30–50% and axial depth by half on the suspect operation. If the fault disappears, the machine is fine and the cutting data is wrong.
- 4Isolate the axisJog each axis by hand at low feed. Listen for a change in pitch and feel for a tight spot. Run the suspect axis through its full travel and watch the load meter.
- 5Inspect tooling and workholdingCheck runout at the holder, insert condition and clamp pressure. Re-torque the fixture. Look for chips packed under the part or in the locating bores.
- 6Check the electrical sideWith the machine locked out, inspect encoder and drive cables at the connectors. Look for coolant tracks, chafing and loose shields. Do not swap drives without matching parameters.
- 7Measure the resultCut a test part and measure it. Compare against the last good part. If size, finish and cycle time are back in band, close the fault log. If not, escalate with the log and photos.
Frequently asked questions about CNC troubleshooting
How long should a machine warm up before I set offsets?
On a machine that has been idle overnight, run the spindle at 30–50% of max rpm for 20–30 minutes and exercise the axes through their normal travel. Then set the offsets and cut the first part.
If you set offsets on a cold machine, the first parts will be small or large depending on the axis and the ambient temperature. A 0.02–0.04 mm shift over the first two hours is normal on many vertical mills.
Why does the same alarm come back at the same point in the cycle?
Repeatable position means the trigger is in the program or the geometry, not in a random electrical fault. Look at the block before the alarm: a rapid into a fixture, a tool change at an unsafe Z, or a canned cycle with a wrong retract plane.
Check the work offset and the tool length for that specific tool. A single wrong tool length will only fail on the operations that use it.
Can I fix a servo fault myself?
If the fault is an overload, yes. Reduce the cut, clear the chips, and check that the axis is not mechanically tight. If the fault is feedback or drive related, stop.
Drive and encoder work needs the right parameters and a way to verify position after the repair. Swapping a drive without matching parameters can drive an axis into a hard stop.
What causes a good machine to suddenly cut tapers?
Taper usually means geometry, not the control. Check the level of the machine, then check backlash and the coupling between the motor and the ballscrew.
On long parts, thermal growth along the screw shows up as a taper that changes during the run. Measure the part at the start and the end of the cycle to separate the two causes.
When should I stop troubleshooting and call a service technician?
Stop when the fault is inside a drive, an encoder, the spindle or the control. Stop when you need a lockout procedure you are not trained for. Stop when you have swapped two parts and the fault follows neither.
Before the call, send the alarm log, the axis, the cycle position, photos of the screen and what you already checked. That information usually cuts the diagnostic time in half.
Does a clean machine really break down less?
Yes, and the reason is mechanical. Chips under the covers act like lapping compound on the linear guides. Coolant that sits in the tank grows bacteria and loses its lubricity, which raises cutting temperature.
A ten-minute daily clean of the table, the way covers and the chip conveyor removes the two most common wear paths we see on machines in the field.
Send us the drawing, we will check the machining side
GreatLight runs 127 high-precision CNC machines across three plants in Dongguan and Singapore. We quote and return a free DFM analysis within 12 hours, and we work from one prototype to 10,000+ part runs.
12-hour quote±0.005 mm tolerance100% inspectionNo minimum order
More machining notes and shop-floor updates
We publish setup notes, tooling trials and inspection data from the factory floor.
