TypeError: expected str, bytes or os.PathLike object, not NoneType
O funcție care lucrează cu fișiere (`open`, `os.path.join`, `os.path.exists`...) a primit `None` în loc de o cale. De obicei calea vine dintr-o variabilă de mediu care nu e setată sau dintr-o funcție fără `return`. Dă o valoare implicită (`os.environ.get("DIR", "date")`) sau verifică valoarea înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile pentru fișiere și directoare acceptă o cale ca text ("date/iunie.csv"), ca bytes sau ca obiect „PathLike”, adică un pathlib.Path. Orice altceva produce TypeError, iar mesajul îți spune ce tip a primit: NoneType, int, list, TextIOWrapper.
NoneType e cel mai des: calea a ieșit None undeva mai sus. Surse tipice: os.environ.get("NUME") când variabila de mediu nu există, os.getenv() la fel, o funcție care calculează calea dar uită return, sau un argument opțional de linie de comandă necompletat. Linia din mesaj arată doar unde a fost folosită calea; cauza e acolo unde a primit valoarea. Varianta cu TextIOWrapper apare când dai lui open() un fișier deja deschis, nu numele lui.
De ce apare: cauzele frecvente
1Variabilă de mediu care lipsește
import os
director = os.environ.get("DIRECTOR_RAPOARTE")
cale = os.path.join(director, "iunie.csv")import os
director = os.environ.get("DIRECTOR_RAPOARTE", "rapoarte")
cale = os.path.join(director, "iunie.csv")Al doilea argument al lui get e valoarea folosită când variabila nu e setată, deci director nu mai poate fi None.
2Funcție care uită return
import os
def cale_raport(luna):
os.path.join("rapoarte", luna + ".csv")
with open(cale_raport("iunie")) as f:
print(f.read())import os
def cale_raport(luna):
return os.path.join("rapoarte", luna + ".csv")
print(cale_raport("iunie"))Fără return, funcția întoarce None, iar open(None) nu are ce fișier să deschidă. La os.path.exists(None), mesajul e stat: path should be string, bytes, os.PathLike or integer, not NoneType.
3Fișier deschis dat în loc de nume
f = open("note.txt", "w")
with open(f) as g:
passwith open("note.txt", "w") as f:
f.write("9\n")open primește numele fișierului, nu un fișier deja deschis. Aici mesajul spune not TextIOWrapper.
Repară eroarea, direct în pagină
Codul de mai jos construiește calea către un raport pornind de la o variabilă de mediu, dar dă TypeError: expected str, bytes or os.PathLike object, not NoneType, pentru că variabila nu e setată. Folosește directorul rapoarte ca valoare implicită, ca programul să afișeze rapoarte/iunie.csv.
import os
director = os.environ.get("DIRECTOR_RAPOARTE")
cale = os.path.join(director, "iunie.csv")
print(cale)rapoarte/iunie.csv
Indiciu
os.environ.get primește și un al doilea argument.
Reparația
import os
director = os.environ.get("DIRECTOR_RAPOARTE", "rapoarte")
cale = os.path.join(director, "iunie.csv")
print(cale)De ce merge
Variabila de mediu DIRECTOR_RAPOARTE nu există, așa că os.environ.get întorcea None, iar os.path.join nu poate lipi None de un nume de fișier. Cu "rapoarte" ca valoare implicită, director e mereu un text, iar calea se construiește corect. Pe Windows, separatorul afișat ar fi \.
Alte forme ale mesajului
TypeError: expected str, bytes or os.PathLike object, not intTypeError: expected str, bytes or os.PathLike object, not TextIOWrapperTypeError: join() argument must be str, bytes, or os.PathLike object, not 'NoneType'TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType
Cum o eviți pe viitor
- Dă valori implicite variabilelor de mediu:
os.environ.get("X", "implicit"), sau foloseșteos.environ["X"]dacă vrei o eroare clară (KeyError) când lipsește. - Verifică la început căile importante:
if director is None: raise ValueError("Setează DIRECTOR_RAPOARTE"). - Folosește
pathlib.Pathși operatorul/pentru căi; codul devine mai scurt și mai clar.
Întrebări frecvente
De ce merge pe calculatorul meu și pe server nu?
Probabil la tine variabila de mediu e setată (în terminal, în IDE sau într-un fișier .env), iar pe server nu. Pe server, os.environ.get dă None.
Pot da un număr ca nume de fișier?
Nu direct. Transformă-l în text: open(str(numar) + ".txt") sau open(f"{numar}.txt").
Erori înrudite
FileNotFoundError: [Errno 2] No such file or directory: 'date.txt' Python nu găsește fișierul pe care vrei să-l deschizi: numele e scris greșit sau calea e relativă la alt folder decât cel din care rulezi programul. Verifică numele exact (inclusiv extensia) și folderul curent cu `os.getcwd()`, sau construiește calea pornind de la locul scriptului. AttributeError: 'NoneType' object has no attribute 'append' Apelezi o metodă (append, split, get, upper...) pe o variabilă care e `None`. De obicei ai salvat rezultatul unei metode care modifică pe loc (`lista = lista.append(x)`) sau al unei funcții fără `return`. Nu salva rezultatul lui `append`/`sort` și verifică ce întorc funcțiile tale. TypeError: 'NoneType' object is not subscriptable Folosești `[ ]` (indice sau cheie) pe o valoare care este `None`. Aproape mereu, valoarea vine de la o funcție care nu are `return` sau de la o metodă care modifică pe loc și întoarce None (de exemplu `lista.sort()`). Verifică de unde vine variabila și returnează valoarea. Î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.
