Troubleshooting QR Code Scan Failures: Diagnosis and Fixes
When a QR code fails to scan, the cause is usually one of five common issues: insufficient contrast, inadequate size, missing quiet zone, data corruption, or environmental interference. Systematic diagnosis identifies the fix quickly.
Diagnostic Flowchart
Step 1: Does It Scan on Any Device?
Test with 3+ different phones. If it scans on some but not others, the issue is marginal — the code is near the failure threshold. If it fails on all devices, the code itself is defective.
Step 2: Check Contrast
The most common cause of scan failure. Measure the contrast ratio between foreground and background. Minimum 4:1 for reliable scanning. Common contrast problems:
- Dark blue on black (ratio ~2:1)
- Light gray on white (ratio ~1.5:1)
- Colored modules on colored background (perceived contrast varies)
- Inverted colors (light modules on dark background)
Fix: Regenerate with black modules on white background.
Step 3: Check Size
Measure the physical QR code size and the scanning distance. Apply the 10:1 rule — if the code is 2 cm wide and you are scanning from 50 cm away, it is too small.
Fix: Increase the printed size or reduce scanning distance.
Step 4: Check Quiet Zone
Is there at least 4 modules of blank space around the code? Busy backgrounds, adjacent text, or decorative borders that intrude into the quiet zone cause the scanner to misidentify the code boundaries.
Fix: Add a white border of at least 4 module widths around the code.
Step 5: Check Data Integrity
Decode the QR code using a verification tool to confirm the data is correct. Encoding errors — truncated URLs, special character corruption, wrong encoding mode — produce codes that decode to garbage data.
Fix: Regenerate the code from the original source data.
Environmental Issues
- Glare: Glossy surfaces under direct light reflect into the camera. Use matte finish or angle the code away from light sources.
- Curvature: Codes printed on bottles or cylinders distort the module grid. Limit the code size to 30% of the cylinder circumference.
- Motion: Scanning a code on a moving conveyor requires high shutter speed and bright lighting. Standard smartphone cameras struggle above 0.5 m/s.
- Screen display: QR codes displayed on screens can fail due to screen refresh rate interference (especially on older monitors) and brightness settings.