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

TypeError: expected str, bytes or os.PathLike object, not NoneType

Pe scurt

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

Greșit
PYTHON
import os
director = os.environ.get("DIRECTOR_RAPOARTE")
cale = os.path.join(director, "iunie.csv")
Corect
PYTHON
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

Greșit
PYTHON
import os
def cale_raport(luna):
    os.path.join("rapoarte", luna + ".csv")
with open(cale_raport("iunie")) as f:
    print(f.read())
Corect
PYTHON
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

Greșit
PYTHON
f = open("note.txt", "w")
with open(f) as g:
    pass
Corect
PYTHON
with 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ă tu

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.

Codul care dă eroarea
PYTHON
import os

director = os.environ.get("DIRECTOR_RAPOARTE")
cale = os.path.join(director, "iunie.csv")
print(cale)
După reparație, programul afișează
rapoarte/iunie.csv
Indiciu

os.environ.get primește și un al doilea argument.

Alte forme ale mesajului

  • TypeError: expected str, bytes or os.PathLike object, not int
  • TypeError: expected str, bytes or os.PathLike object, not TextIOWrapper
  • TypeError: 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ște os.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

← 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.