Lidsky řečeno
Chybová hláška je protokol z autoservisu. Mechanik ti nenadává, jen napíše, co přestalo fungovat a kde to našel. Když si protokol přečteš, víš, co opravit. Když ho vyhodíš a jen znovu otočíš klíčkem, auto nepojede o nic líp.
Co se stane, když program spadne
Běžící program postupuje shora dolů. Narazí-li na něco, co nejde provést, zastaví se a ohlásí výjimku, tedy chybu za běhu. Co stihl vypsat předtím, zůstane. Další řádky už neproběhnou.
print("Připravuji účet.")
cena = 89
print("Cena za kus:", cena)
print("Celkem:", cena * kusy)
print("Tohle se už nevypíše.")
Připravuji účet. Cena za kus: 89
Druhý druh problému je chyba syntaxe. Python si před spuštěním přečte celý program, a když narazí na zápis, kterému nerozumí, nespustí ani první řádek. Proto tahle ukázka nevypíše nic, i když je první řádek v pořádku.
print("Tohle se nevypíše.")
print("Ani tohle."
Program má dva řádky: print("A") a pod ním print("B" bez zavírací závorky. Co se vypíše, než se objeví chyba?
Chybějící závorka je chyba syntaxe. Python ji najde ještě před spuštěním, takže neproběhne vůbec nic.
Hláška se čte odspodu
Když program spustíš na svém počítači, dostaneš takzvaný traceback, česky výpis cesty k chybě. Tady je skutečný z programu ucet.py:
Traceback (most recent call last):
File "C:\kurz\ucet.py", line 3, in <module>
celkem = cena * kusy
^^^^
NameError: name 'kusy' is not defined. Did you mean: 'kusu'?Vypadá to hrozivě, ale podstatné jsou tři údaje. Čti je v tomhle pořadí:
- Poslední řádek říká co. Před dvojtečkou je typ chyby,
NameError, za ní popis. Tady: jménokusyneexistuje, nemyslel jsikusu? - Řádek s
Fileříká kde: soubor a číslo řádku, tady řádek 3. Slovo<module>znamená hlavní část programu, mimo funkce. - Kód a stříšky
^^^^ukazují konkrétní místo na tom řádku.
První řádek, most recent call last, jen oznamuje, že nejnovější krok je dole. Proto se začíná odspodu.
Tady na stránce dostaneš zkrácenou verzi: typ chyby, číslo řádku, popis a českou nápovědu. Zkus to na první ukázce výše. Nabídka Did you mean se ukazuje jen v plném výpisu na počítači a program se na stránce jmenuje <kód>.
Až budeš psát funkce, hláška bude mít víc pater. Každé patro je jeden krok cesty a to nejspodnější je místo pádu:
Traceback (most recent call last):
File "C:\kurz\pokladna.py", line 7, in <module>
uctenka()
File "C:\kurz\pokladna.py", line 5, in uctenka
print(cena_s_dph(100))
^^^^^^^^^^^^^^^
File "C:\kurz\pokladna.py", line 2, in cena_s_dph
return cena * sazba
^^^^^
NameError: name 'sazba' is not definedKde v tracebacku najdeš typ chyby a její popis?
Poslední řádek je nejdůležitější. Začni vždycky od něj.
Nejčastější chyby
Hlášky jsou anglicky, ale slovník je malý. Tahle tabulka pokryje většinu toho, na co teď narazíš.
| Hláška | Česky | Obvyklá příčina |
|---|---|---|
NameError: name 'x' is not defined | jméno x neexistuje | překlep, nebo proměnná vzniká až později |
SyntaxError: '(' was never closed | závorka se nezavřela | chybí ) |
SyntaxError: unterminated string literal | neukončený text | chybí zavírací uvozovka |
SyntaxError: invalid syntax | neplatný zápis | chybí operátor, čárka nebo hodnota |
SyntaxError: invalid character '„' | neplatný znak | české uvozovky zkopírované z Wordu |
IndentationError: unexpected indent | nečekané odsazení | mezery na začátku řádku navíc |
TypeError: can only concatenate str | text jde spojit jen s textem | lepení textu a čísla přes + |
TypeError: unsupported operand type(s) | operace s těmito typy nejde | třeba číslo plus text |
ValueError: invalid literal for int() | tohle není zápis celého čísla | int("abc"), int("3.5") |
ZeroDivisionError: division by zero | dělení nulou | jmenovatel je 0 |
AttributeError: ... has no attribute | tohle hodnota neumí | překlep v názvu metody |
IndexError: string index out of range | pozice mimo text | index je větší než délka |
TypeError znamená špatný druh hodnoty. ValueError znamená správný druh, ale nepoužitelný obsah.
pocet = 3
print("Počet: " + pocet)
print(int("dvacet"))
print("ahoj".uppr())
cena = 10
sleva = 2
Spusť je a přečti si, co hlásí. Pak každou oprav. Nejrychleji se hlášky naučíš tak, že je vyrobíš schválně.
Překlep
Program končí chybou NameError. Přečti si hlášku a oprav ho, ať celkem obsahuje cenu všech káv.
cena_kavy = 62
pocet = 3
celkem = cena_kavi * pocet
print(celkem)
Dvě chyby syntaxe
Program se ani nespustí. Oprav oba řádky, aby vypsal Otevírací doba: a pod to Po až Pá 8-16. Python hlásí vždy jen první problém, takže druhý uvidíš až po opravě prvního.
print("Otevírací doba:)
print("Po až Pá", "8-16"
Text krát desetinné číslo
Program má spočítat cenu za zadaný počet kusů po 25,50 Kč, ale padá. Oprav ho, aby kusu bylo číslo a celkem správná cena.
kusu = input("Kolik kusů? ")
celkem = kusu * 25.5
print(celkem)
Když je chyba jinde, než ukazuje hláška
Hláška říká, kde se problém projevil. To nemusí být místo, kde vznikl. Tady je první řádek špatně, a přesto Python spadne až na třetím.
cena = 10,5
print(cena)
print(cena + 1)
(10, 5)
Desetinná čárka udělala z cena dvojici čísel 10 a 5. To je platný zápis, takže první řádek prošel a chyba vybuchla až při sčítání. Když hláška nedává smysl, vrať se k tomu, odkud hodnota přišla, a vypiš si ji. Funkce repr ukáže hodnotu tak, jak ji vidí Python, včetně uvozovek a skrytých znaků.
cislo = "12\n"
print("Hodnota:", cislo)
print("Přesně:", repr(cislo))
print("Typ:", type(cislo))
Hodnota: 12 Přesně: '12\n' Typ: <class 'str'>
Nejhorší chyba je ta, která žádnou hlášku nemá. Program doběhne a jen vypíše špatný výsledek. Python tvůj záměr nezná, takže ti nepomůže. Pomůže jedině kontrola výsledku na příkladu, který si umíš spočítat v hlavě.
prvni = 4
druhy = 8
print(prvni + druhy / 2)
print((prvni + druhy) / 2)
8.0 6.0
Hláška ukazuje jinam
Program spadne na druhém řádku, ale problém je na prvním. Oprav ho, aby cena byla 10,5 a s_obalem o dvě koruny víc.
cena = 10,5
s_obalem = cena + 2
print(s_obalem)
Tichá chyba
Tenhle program žádnou chybu nehlásí, jen počítá špatně. Průměr ze 4 a 8 je 6. Oprav výpočet.
prvni = 4
druhy = 8
prumer = prvni + druhy / 2
print(prumer)
Postup, když se to rozbije
- Přečti poslední řádek. Co se stalo?
- Podívej se na číslo řádku a na stříšky. Kde se to stalo?
- U chyby syntaxe zkontroluj i řádek nad ním. Chybějící závorka se často projeví až dál.
- Vypiš si podezřelé hodnoty přes
print(repr(x), type(x)). - Oprav jednu věc a spusť program znovu. Další chyba může být schovaná za touto.
Pod kapotou · traceback v produkci
Parser (PEG, PEP 617, od 3.9) po neúspěchu projde zdroj podruhé se speciálními pravidly invalid_* a z nich vznikají přesnější hlášky. Stříšky na úrovni výrazu přinesl PEP 657 ve 3.11. Pozice jsou uložené v code objektu (co_positions), stojí to trochu paměti a dají se vypnout přes -X no_debug_ranges.
SyntaxError zastaví program před startem jen v souboru, který spouštíš. V importovaném modulu nastane až při import, takže aplikace může běžet a spadnout v líně načítané cestě. V CI to odhalí python -m compileall nebo linter.
Nápověda Did you mean není součástí zprávy výjimky, dopočítá se až při formátování. Log z str(e) ji neobsahuje a chybí v něm i typ a zásobník:
import traceback
try:
"ahoj".uppr()
except AttributeError as e:
print(str(e))
print(traceback.format_exception_only(e)[-1].strip())
'str' object has no attribute 'uppr' AttributeError: 'str' object has no attribute 'uppr'. Did you mean: 'upper'?
V logu proto používej logger.exception(...), které přidá celý traceback.
Řetězené výjimky mají dvě podoby. During handling of the above exception... znamená implicitní __context__, The above exception was the direct cause... znamená raise X from e (__cause__). Skutečná příčina bývá v prvním bloku, ne v posledním. Ke kontextu se dají přidat poznámky přes e.add_note() (PEP 678).
Hierarchie rozhoduje o tom, co zachytí except: IndentationError je podtřída SyntaxError, IndexError a KeyError patří pod LookupError, ZeroDivisionError pod ArithmeticError, ModuleNotFoundError pod ImportError. KeyboardInterrupt a SystemExit nejsou pod Exception, jen pod BaseException.
Traceback drží odkazy na rámce a přes ně na lokální proměnné. Uložená výjimka tak brání uvolnění paměti a nástroje, které ukládají lokální proměnné k chybě, mohou do logů vynést hesla a tokeny. Při pádu na úrovni interpreteru, kde žádný traceback nevznikne, pomůže python -X faulthandler.