...
Eroare Python · Erori de tip (TypeError)

TypeError: isinstance() arg 2 must be a type, a tuple of types, or a union

Pe scurt

Al doilea argument al lui isinstance trebuie să fie un tip (int, str, o clasă), un tuplu de tipuri sau o uniune int | float, nu un text precum "int" sau o valoare. Scrie isinstance(x, int), fără ghilimele.

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

Ce înseamnă

isinstance(obiect, tip) verifică dacă obiectul e de un anumit tip. Al doilea argument trebuie să fie chiar tipul: int, str, list, o clasă a ta, un tuplu (int, float) sau, din Python 3.10, o uniune int | float. Dacă îi dai altceva, de exemplu numele tipului ca text ("int"), o valoare (0) sau o listă [int, float], primești acest mesaj.

O formă înrudită: isinstance() argument 2 cannot be a parameterized generic, când scrii isinstance(x, list[int]). Verificarea la rulare se poate face doar pe tipul „de bază” (list), nu și pe tipul elementelor.

În mod similar, issubclass(x, Baza) cere ca primul argument să fie o clasă: issubclass() arg 1 must be a class.

De ce apare: cauzele frecvente

1Numele tipului ca text

Greșit
PYTHON
x = 5
print(isinstance(x, "int"))
Corect
PYTHON
x = 5
print(isinstance(x, int))

int (fără ghilimele) e tipul însuși; "int" e doar un text.

2Listă de tipuri în loc de tuplu

Greșit
PYTHON
x = 2.5
print(isinstance(x, [int, float]))
Corect
PYTHON
x = 2.5
print(isinstance(x, (int, float)))

Funcția acceptă mai multe tipuri doar ca tuplu (sau int | float), nu ca listă.

3Tip generic parametrizat

Greșit
PYTHON
note = [9, 10]
print(isinstance(note, list[int]))
Corect
PYTHON
note = [9, 10]
print(isinstance(note, list) and all(isinstance(n, int) for n in note))

list[int] e doar pentru adnotări. La rulare verifici list, apoi elementele separat.

Repară tu

Repară eroarea, direct în pagină

Funcția e_numar ar trebui să spună dacă o valoare este număr întreg sau zecimal, dar dă TypeError: isinstance() arg 2 must be a type, a tuple of types, or a union. Repar-o ca programul să afișeze True True False.

Codul care dă eroarea
PYTHON
def e_numar(valoare):
    return isinstance(valoare, ["int", "float"])

print(e_numar(3), e_numar(2.5), e_numar("7"))
După reparație, programul afișează
True True False
Indiciu

Tipurile se scriu fără ghilimele, iar mai multe tipuri se grupează într-un tuplu.

Alte forme ale mesajului

  • TypeError: isinstance() argument 2 cannot be a parameterized generic
  • TypeError: issubclass() arg 1 must be a class
  • TypeError: issubclass() arg 2 must be a class, a tuple of classes, or a union

Cum o eviți pe viitor

  • Scrie tipurile fără ghilimele în isinstance: int, str, dict.
  • Pentru mai multe tipuri, folosește un tuplu (int, float) sau int | float.
  • Nu pune tipuri generice cu paranteze pătrate (list[int], dict[str, int]) în isinstance; ele sunt pentru adnotări și pentru verificatoare ca mypy.
  • Dacă primești numele tipului ca text dintr-o configurație, transformă-l printr-un dicționar: {"int": int, "str": str}.

Întrebări frecvente

E mai bine type(x) == int sau isinstance(x, int)?

De regulă isinstance, pentru că acceptă și subclasele. Atenție doar că bool e subclasă a lui int, deci isinstance(True, int) e True.

Cum verific că o listă conține doar numere?

isinstance(lista, list) and all(isinstance(x, (int, float)) for x in lista). Verificarea pe elemente se face explicit.

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.