...
Eroare Python · Atribute, metode și None

AttributeError: 'str' object has no attribute 'decode'. Did you mean: 'encode'?

Pe scurt

Ai apelat .decode() pe un text (str). În Python 3, textul e deja decodat; decode() există doar pe bytes. Șterge apelul .decode(...), iar dacă ai nevoie de octeți, folosește invers: text.encode("utf-8").

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

Ce înseamnă

Python 3 separă clar două tipuri: str (text, caractere Unicode) și bytes (octeți). Conversiile merg așa: bytes.decode("utf-8") → str și str.encode("utf-8") → bytes. Un str nu are metoda decode, pentru că nu mai e nimic de decodat.

Mesajul îți spune că obiectul pe care ai chemat .decode() e un str, iar sugestia Did you mean: 'encode'? vine din faptul că e cea mai apropiată metodă existentă. De cele mai multe ori nu ai nevoie nici de encode: trebuie doar să ștergi .decode(...).

Eroarea apare des în cod copiat din tutoriale vechi pentru Python 2, unde textele citite din fișiere și rețea erau octeți. Apare și când o bibliotecă a început să întoarcă str în loc de bytes (de exemplu jwt.encode în PyJWT 2, subprocess cu text=True, base64 decodat deja).

De ce apare: cauzele frecvente

1Cod din Python 2 pe un text

Greșit
PYTHON
linie = "Preț: 25 lei"
print(linie.decode("utf-8"))
Corect
PYTHON
linie = "Preț: 25 lei"
print(linie)

Textul e deja str, gata de folosit; nu mai trebuie decodat.

2Decodezi de două ori

Greșit
PYTHON
date = b"Bun\xc4\x83"
text = date.decode("utf-8")
print(text.decode("utf-8"))
Corect
PYTHON
date = b"Bun\xc4\x83"
text = date.decode("utf-8")
print(text)

Primul decode a transformat octeții în text; al doilea nu mai are pe ce lucra.

3O bibliotecă întoarce acum str

Greșit
PYTHON
import base64
token = base64.b64encode(b"user:parola").decode("ascii")
antet = "Basic " + token.decode("ascii")
Corect
PYTHON
import base64
token = base64.b64encode(b"user:parola").decode("ascii")
antet = "Basic " + token
print(antet)

Verifică tipul valorii cu type(token) înainte să-l convertești; aici era deja str.

Repară tu

Repară eroarea, direct în pagină

Funcția curata primește liniile unui fișier și le pregătește pentru afișare. A fost copiată dintr-un tutorial vechi și dă AttributeError: 'str' object has no attribute 'decode'. Did you mean: 'encode'?. Repar-o ca să afișeze ANA POPESCU și MIHAI ION.

Codul care dă eroarea
PYTHON
def curata(linie):
    return linie.decode("utf-8").strip().upper()

linii = ["  ana popescu\n", "mihai ion  \n"]
for linie in linii:
    print(curata(linie))
După reparație, programul afișează
ANA POPESCU
MIHAI ION
Indiciu

Liniile sunt deja texte în Python 3.

Alte forme ale mesajului

  • AttributeError: 'str' object has no attribute 'decode'

Cum o eviți pe viitor

  • Regula: bytes.decode() → str, str.encode() → bytes. Pe un str nu există decode.
  • Decodează o singură dată, cât mai aproape de locul unde intră datele (citire de fișier binar, rețea).
  • Deschide fișierele text cu open(cale, encoding="utf-8"): primești direct str.
  • Când adaptezi cod vechi, caută toate apelurile .decode( și verifică tipul fiecărei valori.

Întrebări frecvente

De ce codul mergea pe Python 2?

În Python 2, tipul str era de fapt un șir de octeți și avea decode. În Python 3, str e text Unicode, iar octeții au tipul separat bytes.

Cum aflu dacă am str sau bytes?

print(type(x)) sau print(repr(x)): octeții apar cu prefixul b, ca b'abc'. Poți scrie și if isinstance(x, bytes): x = x.decode("utf-8").

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.