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

TypeError: a bytes-like object is required, not 'str'

Pe scurt

Amesteci bytes (`b"..."`) cu texte (`str`): de exemplu faci `split(",")` pe date binare, cauți un text într-un bytes sau scrii text într-un fișier deschis cu `"wb"`. Decodează datele cu `.decode("utf-8")` sau lucrează doar cu bytes (`b","`).

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

Ce înseamnă

În Python 3, textul (str) și octeții (bytes) sunt tipuri diferite, iar operațiile nu le amestecă. Datele vin ca bytes din fișiere deschise în mod binar ("rb"), din rețea (socket-uri, response.content la requests), din subprocess fără text=True sau din encode(). Metodele lui bytes (split, replace, startswith, in) cer argumente tot bytes, iar mesajul îți spune că a primit str.

Opusul, TypeError: write() argument must be str, not bytes sau can't concat str to bytes, înseamnă aceeași confuzie în sens invers. Regula simplă: decodează bytes în text cât mai devreme (la citire) și encodează textul în bytes cât mai târziu (la scriere/trimitere).

De ce apare: cauzele frecvente

1split cu text pe date binare

Greșit
PYTHON
date = b"ana,ion,maria"
nume = date.split(",")
Corect
PYTHON
date = b"ana,ion,maria"
nume = date.decode("utf-8").split(",")

După decode, datele sunt text, iar split(",") merge. Alternativ: date.split(b",").

2Căutare de text în bytes

Greșit
PYTHON
raspuns = b"status: ok"
if "ok" in raspuns:
    print("merge")
Corect
PYTHON
raspuns = b"status: ok"
if b"ok" in raspuns:
    print("merge")

Într-un bytes poți căuta doar bytes. Prefixul b face din "ok" un bytes.

3Text scris într-un fișier binar

Greșit
PYTHON
with open("raport.txt", "wb") as f:
    f.write("Total: 100")
Corect
PYTHON
with open("raport.txt", "w", encoding="utf-8") as f:
    f.write("Total: 100")

Modul "wb" cere bytes. Pentru text, deschide fișierul în mod text, cu encoding explicit.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos primește date binare (ca de la o conexiune de rețea) și dă TypeError: a bytes-like object is required, not 'str'. Decodează datele în text înainte de procesare, ca programul să afișeze ['mere', 'pere', 'prune'] și Produse: 3.

Codul care dă eroarea
PYTHON
date = b"mere;pere;prune"
produse = date.split(";")
print(produse)
print("Produse:", len(produse))
După reparație, programul afișează
['mere', 'pere', 'prune']
Produse: 3
Indiciu

Folosește .decode("utf-8") pe date înainte de split.

Alte forme ale mesajului

  • TypeError: can't concat str to bytes
  • TypeError: write() argument must be str, not bytes
  • TypeError: a bytes-like object is required, not 'int'
  • TypeError: argument should be integer or bytes-like object, not 'str'

Cum o eviți pe viitor

  • Deschide fișierele text cu "r"/"w" și encoding="utf-8"; folosește "rb"/"wb" doar pentru date binare (imagini, arhive).
  • Decodează imediat ce primești bytes: text = date.decode("utf-8").
  • La requests, folosește response.text sau response.json() în loc de response.content când vrei text.
  • La subprocess.run, adaugă text=True.

Întrebări frecvente

Cum îmi dau seama dacă am bytes sau text?

Afișează valoarea: bytes apar cu b în față (b'abc'). Sau verifică type(x), care arată <class 'bytes'> ori <class 'str'>.

Ce encoding folosesc la decode?

Aproape mereu utf-8. Dacă primești UnicodeDecodeError, datele au fost salvate cu alt encoding, de exemplu cp1250 sau latin-1 la fișiere vechi din Windows.

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.