Skip to content

Troubleshooting

Troubleshooting is the systematic skill of diagnosing and resolving problems at the espresso bar — from unexpected extraction behaviour to equipment faults, from inconsistent milk texture to unusual drink quality. At Level 3, a barista is expected to identify and resolve most common problems independently, and to know when to escalate rather than attempt a fix beyond their competency.

→ Part of Barista Skill Progression Levels — Level 3 Technical Competency


The Troubleshooting Mindset

Effective troubleshooting requires:

  1. Observe the symptom precisely — what exactly is wrong? ("The shot runs in 18 seconds" is more useful than "the shot tastes bad")
  2. Hypothesise — what could cause this? Work from the most likely to least likely
  3. Test one thing at a time — changing multiple variables simultaneously produces ambiguous results
  4. Verify the fix — confirm the problem is resolved before returning to service
  5. Document — record the problem and solution for future reference

Espresso Extraction Problems

Symptom Likely Causes First Steps
Shot runs too fast (<20s) Grind too coarse; dose too low; channelling Check dose; adjust grind finer; check distribution
Shot runs too slow (>40s) Grind too fine; dose too high; old coffee Check dose; adjust grind coarser
Shot channels (uneven flow) Poor distribution; uneven tamp; worn basket Re-examine distribution and tamp technique; check basket
Shot runs fast even after grind adjustment Burrs worn; dosing consistently low; basket damaged Check dose weight; inspect basket; consider burr wear
No crema or very thin crema Very fresh coffee (too gassy); very stale coffee Check roast date; adjust to allow outgassing; consider new bag
Sour and bitter simultaneously Channelling (over and under-extracted in same cup) Fix distribution and tamping before adjusting grind
Shot pulls correctly but tastes wrong Green coffee defect; roasting defect; stale bag Compare against a reference batch; escalate to buyer/roaster

Milk Problems

Symptom Likely Causes First Steps
Large bubbles in milk Steam tip too shallow during stretch; condensation in wand Purge wand before steaming; adjust tip depth
Milk separated (foam on top, thin liquid below) Over-steamed; waited too long to pour Reduce temperature; pour immediately
Milk scorched (burnt smell) Over-heated (above 70°C) Stop steaming earlier; use thermometer to verify
Alternative milk splitting in the cup Acidity of espresso causing protein coagulation Use barista-specific alternative milk; pour quickly; slightly lower acidity coffee
Steam wand not producing pressure Boiler not up to temperature; blocked tip Allow machine to heat; clean and inspect tip

Equipment Faults

Espresso Machine

Symptom Possible Cause Action
Group head leaking during extraction Worn group gasket Flag for maintenance; avoid using that group
Machine not reaching temperature Boiler issue; scale buildup Escalate to technician
Pressure gauge reading unusually low or high OPV issue; blocked line Stop using machine; contact technician
Machine making unusual noise Pump wear; scale buildup; air lock Escalate to technician
Shot stopping mid-extraction Volumetric calibration issue; pump issue Switch to manual override if available; call technician

Grinder

Symptom Possible Cause Action
Grinder jammed Foreign object; bean caught in burrs Turn off and unplug; do not reach in; use clearing tool or call technician
Unusually long grind times Burr wear; hopper issue Check hopper; flag for burr inspection
Grinder dosing inconsistently Static buildup; worn dosing mechanism Check for static; tap hopper; flag for service
Unusual grinding sound Foreign object; burr damage Stop immediately; inspect and escalate

When to Escalate

Not all problems are within a barista's remit to fix. Escalate immediately when:

  • The problem involves internal machine components (boiler, pump, valves)
  • Electrical components are showing unusual behaviour
  • There is water leaking from parts of the machine that should be dry
  • The problem persists after basic troubleshooting and is affecting service quality
  • Any safety concern is present

Escalating is not a failure — it is the correct response to a problem outside one's competency. Attempting to fix mechanical or electrical problems without the appropriate skills risks damaging expensive equipment and creating safety hazards.


Building a Troubleshooting Log

At Level 3, the barista should maintain or contribute to a troubleshooting log:

Date: [date]
Problem: [specific description]
Diagnosed cause: [hypothesis and evidence]
Action taken: [what was done]
Result: [resolved / escalated / monitoring]
Notes: [anything useful for next time]

This log is invaluable for identifying recurring problems, tracking equipment degradation, and training newer staff.


Assessment

An Advanced Barista should be able to: - Diagnose the most common espresso, milk, and equipment problems without assistance - Distinguish problems within their scope from those requiring a technician - Pull the machine from service safely when a fault creates a safety or quality risk - Maintain a basic troubleshooting record



Part of 05_PUBLISHING/Homepage/Coffeepedia - The comprehensive coffee knowledge vault