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

NotImplementedError

Pe scurt

Ai apelat o metodă care, în clasa de bază, doar ridică `NotImplementedError`, ca semn că fiecare subclasă trebuie s-o scrie. Implementează metoda în subclasa ta, cu exact același nume, sau creează obiectul din subclasa corectă.

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

Ce înseamnă

NotImplementedError e excepția prin care o clasă de bază spune „această metodă trebuie implementată de subclase”. De exemplu, Forma.arie() ridică NotImplementedError, iar Patrat și Cerc o suprascriu cu formula lor. Dacă apelezi arie() pe un obiect a cărui clasă nu a suprascris metoda, ajungi la versiunea din bază și primești excepția.

Cauzele obișnuite: ai uitat să scrii metoda în subclasă, ai scris-o cu alt nume (aria în loc de arie), ai greșit numărul de parametri, sau ai creat obiectul direct din clasa de bază. Apare și în biblioteci: unele funcții nu sunt disponibile pe un anumit sistem sau backend și ridică NotImplementedError cu un mesaj explicativ. Pentru o verificare mai timpurie, poți folosi abc.ABC și @abstractmethod: atunci obiectul nici nu poate fi creat fără implementare.

De ce apare: cauzele frecvente

1Metodă scrisă cu alt nume

Greșit
PYTHON
class Forma:
    def arie(self):
        raise NotImplementedError
class Patrat(Forma):
    def aria(self):
        return 9
Patrat().arie()
Corect
PYTHON
class Forma:
    def arie(self):
        raise NotImplementedError
class Patrat(Forma):
    def arie(self):
        return 9
print(Patrat().arie())

Doar o metodă cu exact același nume suprascrie metoda din bază.

2Obiect creat din clasa de bază

Greșit
PYTHON
class Notificare:
    def trimite(self, mesaj):
        raise NotImplementedError("Folosește Email sau SMS")
Notificare().trimite("Salut")
Corect
PYTHON
class Notificare:
    def trimite(self, mesaj):
        raise NotImplementedError("Folosește Email sau SMS")
class Email(Notificare):
    def trimite(self, mesaj):
        print("Email:", mesaj)
Email().trimite("Salut")

Clasa de bază e doar un șablon. Obiectele se creează din subclasele care implementează metoda.

Repară tu

Repară eroarea, direct în pagină

Clasa Patrat de mai jos ar trebui să calculeze aria, dar Patrat(3).arie() dă NotImplementedError: Subclasele trebuie să implementeze arie(). Repară subclasa, ca programul să afișeze 9.

Codul care dă eroarea
PYTHON
class Forma:
    def arie(self):
        raise NotImplementedError("Subclasele trebuie să implementeze arie()")

class Patrat(Forma):
    def __init__(self, latura):
        self.latura = latura

    def aria(self):
        return self.latura ** 2

print(Patrat(3).arie())
După reparație, programul afișează
9
Indiciu

Compară numele metodei din Patrat cu cel din Forma.

Alte forme ale mesajului

  • NotImplementedError: Subclasele trebuie să implementeze arie()

Cum o eviți pe viitor

  • Pentru clasele de bază, folosește abc.ABC cu @abstractmethod: Python refuză crearea obiectelor care nu implementează metoda.
  • Folosește decoratorul @override (din typing, Python 3.12+), ca verificatorul de tipuri să semnaleze o metodă care nu suprascrie nimic din cauza unui nume greșit.
  • Pune un mesaj clar în NotImplementedError, care spune ce trebuie implementat.

Întrebări frecvente

Care e diferența dintre NotImplementedError și NotImplemented?

NotImplementedError e o excepție, pentru metode neimplementate. NotImplemented e o valoare specială pe care o întorc metodele de comparație sau operatorii (__eq__, __add__) când nu știu să trateze tipul primit. raise NotImplemented dă TypeError.

E mai bine NotImplementedError sau @abstractmethod?

@abstractmethod prinde problema mai devreme, la crearea obiectului (TypeError: Can't instantiate abstract class). NotImplementedError e mai simplu și apare doar când apelezi metoda.

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.