...
Eroare Python · Excepții, aserțiuni și generatoare

AssertionError

Pe scurt

O instrucțiune `assert conditie` a găsit condiția falsă. Asta înseamnă de obicei că un test a picat sau că o valoare nu e cea așteptată: citește condiția (și mesajul de după virgulă, dacă există) și repară codul testat, nu verificarea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

assert conditie, "mesaj" e o verificare: dacă condiția e adevărată, nu se întâmplă nimic; dacă e falsă, Python ridică AssertionError, cu mesajul dat (sau fără mesaj). Se folosește în teste (pytest se bazează pe assert) și ca plasă de siguranță în cod, pentru situații care „nu ar trebui să apară niciodată”.

Când primești AssertionError, linia din traceback arată verificarea care a picat. Întrebarea e: condiția e greșită sau codul testat? Aproape mereu, codul testat. Pytest îți arată și valorile comparate (assert 190 == 180), ceea ce ajută mult. Atenție: assert nu e potrivit pentru validarea datelor de la utilizator, pentru că Python rulat cu -O elimină toate aserțiunile; acolo folosește if ...: raise ValueError(...). O capcană clasică: assert (x, "mesaj") cu paranteze e mereu adevărat, pentru că un tuplu nevid e adevărat.

De ce apare: cauzele frecvente

1Bug în funcția testată

Greșit
PYTHON
def pret_final(pret, reducere):
    return pret - reducere * 100
assert pret_final(200, 0.1) == 180, "10% din 200 trebuie să dea 180"
Corect
PYTHON
def pret_final(pret, reducere):
    return pret * (1 - reducere)
assert pret_final(200, 0.1) == 180, "10% din 200 trebuie să dea 180"
print("ok")

Verificarea era corectă; formula greșită scădea 10 lei, nu 10%.

2Comparație exactă între numere zecimale

Greșit
PYTHON
assert 0.1 + 0.2 == 0.3
Corect
PYTHON
import math
assert math.isclose(0.1 + 0.2, 0.3)
print("ok")

0.1 + 0.2 dă 0.30000000000000004. Pentru zecimale, compară cu o toleranță (math.isclose sau pytest.approx).

Repară tu

Repară eroarea, direct în pagină

Testul de mai jos verifică funcția pret_final, care aplică o reducere procentuală, și dă AssertionError: reducerea de 10% trebuie să dea 180. Repară formula din funcție (nu testul), ca programul să afișeze Testele au trecut.

Codul care dă eroarea
PYTHON
def pret_final(pret, reducere):
    return pret - reducere * 100

assert pret_final(200, 0.1) == 180, "reducerea de 10% trebuie să dea 180"
assert pret_final(50, 0.5) == 25, "reducerea de 50% trebuie să dea 25"
print("Testele au trecut")
După reparație, programul afișează
Testele au trecut
Indiciu

O reducere de 10% înseamnă că plătești 90% din preț.

Alte forme ale mesajului

  • AssertionError: reducerea de 10% trebuie să dea 180

Cum o eviți pe viitor

  • Scrie un mesaj clar după virgulă, care spune ce se aștepta: assert x > 0, f"x trebuie pozitiv, e {x}".
  • Folosește assert pentru teste și invarianți interni, nu pentru validarea datelor de intrare.
  • Pentru numere zecimale, compară cu math.isclose sau pytest.approx.
  • Nu pune paranteze în jurul întregului assert: assert (cond, "mesaj") nu verifică nimic.

Întrebări frecvente

De ce AssertionError nu are niciun mesaj?

Pentru că assert a fost scris fără al doilea argument. Adaugă un mesaj după virgulă, sau folosește pytest, care afișează automat valorile comparate.

Pot folosi assert ca să verific ce introduce utilizatorul?

Nu e recomandat: rulat cu python -O, Python elimină toate aserțiunile, iar verificarea dispare. Pentru date de intrare, folosește if și raise ValueError(...).

Erori înrudite

← Toate erorile Python

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python de la zero, cu exerciții la fiecare lecție

Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.