TypeError: a bytes-like object is required, not 'str'
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
date = b"ana,ion,maria"
nume = date.split(",")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
raspuns = b"status: ok"
if "ok" in raspuns:
print("merge")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
with open("raport.txt", "wb") as f:
f.write("Total: 100")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ă 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.
date = b"mere;pere;prune"
produse = date.split(";")
print(produse)
print("Produse:", len(produse))['mere', 'pere', 'prune'] Produse: 3
Indiciu
Folosește .decode("utf-8") pe date înainte de split.
Reparația
date = b"mere;pere;prune"
produse = date.decode("utf-8").split(";")
print(produse)
print("Produse:", len(produse))De ce merge
date e de tip bytes, iar bytes.split cere și separatorul tot bytes, nu text. După decode("utf-8"), valoarea devine un str, split(";") funcționează, iar rezultatul e o listă de texte obișnuite, fără prefixul b.
Alte forme ale mesajului
TypeError: can't concat str to bytesTypeError: write() argument must be str, not bytesTypeError: 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"șiencoding="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șteresponse.textsauresponse.json()în loc deresponse.contentcâ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
TypeError: write() argument must be str, not int Metoda `write()` a unui fișier deschis în mod text primește doar texte, iar tu i-ai dat un număr (sau o listă, un dicționar). Spre deosebire de `print`, `write` nu convertește singur. Scrie `f.write(str(x))` sau, mai bine, `f.write(f"{x}\n")`. UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 15: invalid continuation byte Fișierul (sau datele) nu e salvat în UTF-8, ci în alt encoding, de obicei unul vechi de Windows (`cp1250`, `latin-1`) sau e un Excel salvat ca CSV. Deschide-l cu encoding-ul corect: `open("fisier.csv", encoding="cp1250")`, sau resalvează-l ca UTF-8. TypeError: can only concatenate str (not "int") to str Încerci să lipești cu `+` un text (str) cu un număr (int). Python nu transformă singur numărul în text. Folosește un f-string (`f"Total: {total}"`), `str(total)` sau dă valorile separat lui `print`, cu virgulă. Î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.
