Nesulad kontrolneho suctu? 9 skutocnych pricin a ako ich opravit (2026)
Rychla odpoved: Ak sa checksum lisi co i len o jeden znak, povazuj subor za nedoveryhodny. Stiahni ho znovu z oficialneho zdroja a over opakovane cez SHA-256.
Checksum mismatch znamena, ze lokalny subor nie je byte-po-byte zhodny s ocakavanym artefaktom. Niekedy ide o nahodne poskodenie, inokedy o zmenu balicka, mirror drift alebo manipulaciu.
Co mismatch skutocne dokazuje
Hash je odtlacok bajtov suboru. Ak sa zmeni jediny bajt, zmeni sa aj hash. Mismatch teda dokazuje rozdiel obsahu, nie presnu pricinu zmeny.
9 skutocnych pricin checksum mismatch
- Nespravna verzia suboru: porovnavas hash z ineho buildu.
- Necely download: prenos bol preruseny alebo zle obnoveny.
- Zly algoritmus: lokalne MD5 porovnavas s publikovanym SHA-256.
- Desynchronizovany mirror: CDN/mirror vracia starsi alebo prebaleny artefakt.
- Chyba kopirovania: v ocakavanom hash retazci chybaju znaky.
- Lokalna uprava: antivirus, skript alebo pouzivatel zmenili subor.
- Rekompresia po ceste: proxy alebo middlebox zmenil payload.
- Konverzia koncov riadkov: textovy artefakt upravil editor/tooling.
- Nedoveryhodny zdroj hashu: hash bol prevzaty z cudzej stranky.
2-minutovy triage workflow
- Stahuj iba z oficialneho zdroja.
- Porovnavaj cely SHA-256 retazec.
- Pouzi rovnaky algoritmus ako v publikacii.
- Porovnaj s doveryhodnym kanalom (vendor page alebo podpisane release notes).
- Ak mismatch pretrva, subor vyrad a eskaluj overenie povodu.
Mapa pricin: symptom -> akcia
| Symptom | Pravdepodobna pricina | Co urobit |
|---|---|---|
| Hash sa meni medzi pokusmi | Nestabilny prenos | Zmen siet/mirror, over velkost suboru a podpis |
| Mismtach iba v jednom prostredi | Lokalny nastroj meni subor | Hashuj v cistom prostredi alebo kontajneri |
| SHA-256 nesedi, ale MD5 ano | Porovnavas zle publikovane pole | Skontroluj release notes a oznacenie algoritmu |
| Mismtach iba na mirror URL | Mirror lag alebo repackaging | Pouzi primarny download endpoint dodavatela |
Automatizacny checklist pre timy
- Ukladaj ocakavane hashe do verzovanych manifestov.
- Validuj checksum v CI pred promote/deploy krokom.
- Pri mismatch automaticky failni build.
- Loguj algoritmus aj zdrojovu URL pre audit.
Nastroje a dalsie kroky
Na rychle overenie pouzi Checksum Verifier. Na generovanie testovacich hashov pouzi Hash Generator. Kompletny postup najdes v clanku Ako overit integritu suboru pomocou hashov.