0 dní v řadě · 0 bodů

První kroky · 18 min

Jak číst chybové hlášky

Chybová hláška není trest, ale přesný popis problému. Naučíš se ji číst odspodu a opravit nejčastější chyby začátečníků.

Hloubka
Úkoly
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.")
Výstup
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."
Výstup
Kvíz

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?

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:

text
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í:

  1. Poslední řádek říká co. Před dvojtečkou je typ chyby, NameError, za ní popis. Tady: jméno kusy neexistuje, nemyslel jsi kusu?
  2. Řádek s File říká kde: soubor a číslo řádku, tady řádek 3. Slovo <module> znamená hlavní část programu, mimo funkce.
  3. 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:

text
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 defined
Kvíz

Kde v tracebacku najdeš typ chyby a její popis?

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ČeskyObvyklá příčina
NameError: name 'x' is not definedjméno x neexistujepřeklep, nebo proměnná vzniká až později
SyntaxError: '(' was never closedzávorka se nezavřelachybí )
SyntaxError: unterminated string literalneukončený textchybí zavírací uvozovka
SyntaxError: invalid syntaxneplatný zápischybí operátor, čárka nebo hodnota
SyntaxError: invalid character '„'neplatný znakčeské uvozovky zkopírované z Wordu
IndentationError: unexpected indentnečekané odsazenímezery na začátku řádku navíc
TypeError: can only concatenate strtext jde spojit jen s textemlepení textu a čísla přes +
TypeError: unsupported operand type(s)operace s těmito typy nejdetřeba číslo plus text
ValueError: invalid literal for int()tohle není zápis celého číslaint("abc"), int("3.5")
ZeroDivisionError: division by zerodělení nuloujmenovatel je 0
AttributeError: ... has no attributetohle hodnota neumípřeklep v názvu metody
IndexError: string index out of rangepozice mimo textindex 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)
Výstup
print(int("dvacet"))
Výstup
print("ahoj".uppr())
Výstup
cena = 10
  sleva = 2
Výstup

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ě.

Úkol

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)
Výstup
Úkol

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"
Výstup
Úkol

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)
Výstup

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)
Výstup
(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))
Výstup
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)
Výstup
8.0
6.0
Úkol

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)
Výstup
Úkol

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)
Výstup

Postup, když se to rozbije

  1. Přečti poslední řádek. Co se stalo?
  2. Podívej se na číslo řádku a na stříšky. Kde se to stalo?
  3. U chyby syntaxe zkontroluj i řádek nad ním. Chybějící závorka se často projeví až dál.
  4. Vypiš si podezřelé hodnoty přes print(repr(x), type(x)).
  5. 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())
Výstup
'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.