...
Eroare Python · Module și fișiere

FileExistsError: [Errno 17] File exists: 'rapoarte'

Pe scurt

Ai încercat să creezi un director (cu `os.mkdir`) sau un fișier nou (cu modul `"x"`) care există deja. Pentru directoare folosește `os.makedirs("rapoarte", exist_ok=True)` sau `Path("rapoarte").mkdir(exist_ok=True)`, care nu dau eroare dacă directorul există.

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

Ce înseamnă

FileExistsError e o subclasă a lui OSError, cu codul de sistem 17 (EEXIST). Apare când ceri sistemului de operare să creeze ceva care e deja acolo: os.mkdir("rapoarte") când directorul există, open("raport.txt", "x") (modul „creează, dar doar dacă nu există”) când fișierul există, sau os.rename/os.symlink pe Windows când destinația e ocupată.

Cel mai des, scriptul a mers prima dată, iar a doua rulare pică, pentru că directorul creat atunci a rămas pe disc. Mesajul îți spune calea. Pe Windows, același lucru apare ca [WinError 183] Cannot create a file when that file already exists. Reparația depinde de intenție: dacă e în regulă ca directorul să existe, cere crearea „dacă lipsește”; dacă trebuie să nu suprascrii un fișier, prinde excepția și tratează cazul.

De ce apare: cauzele frecvente

1mkdir rulat a doua oară

Greșit
PYTHON
import os
os.mkdir("rapoarte")
os.mkdir("rapoarte")
Corect
PYTHON
import os
os.makedirs("rapoarte", exist_ok=True)
os.makedirs("rapoarte", exist_ok=True)

exist_ok=True spune: creează directorul dacă lipsește, iar dacă există, nu e o eroare.

2Mod "x" pe un fișier existent

Greșit
PYTHON
open("raport.txt", "w").close()
with open("raport.txt", "x") as f:
    f.write("nou")
Corect
PYTHON
open("raport.txt", "w").close()
try:
    with open("raport.txt", "x") as f:
        f.write("nou")
except FileExistsError:
    print("Raportul există deja, nu-l suprascriu")

Modul "x" e ales tocmai ca să nu suprascrii; tratează cazul în care fișierul există.

3Cu pathlib

Greșit
PYTHON
from pathlib import Path
Path("export").mkdir()
Path("export").mkdir()
Corect
PYTHON
from pathlib import Path
Path("export/2025").mkdir(parents=True, exist_ok=True)

parents=True creează și directoarele intermediare, iar exist_ok=True acceptă directorul existent.

Repară tu

Repară eroarea, direct în pagină

Funcția de mai jos pregătește directorul pentru rapoarte și e apelată de două ori, iar al doilea apel dă FileExistsError: [Errno 17] File exists: 'rapoarte'. Repară funcția, ca ambele apeluri să meargă și programul să afișeze de două ori Director gata: rapoarte.

Codul care dă eroarea
PYTHON
import os

def pregateste():
    os.mkdir("rapoarte")
    print("Director gata:", "rapoarte")

pregateste()
pregateste()
După reparație, programul afișează
Director gata: rapoarte
Director gata: rapoarte
Indiciu

Există o funcție din os care acceptă exist_ok=True.

Alte forme ale mesajului

  • FileExistsError: [Errno 17] File exists: 'raport.txt'
  • FileExistsError: [WinError 183] Cannot create a file when that file already exists: 'rapoarte'

Cum o eviți pe viitor

  • Pentru directoare, folosește din start os.makedirs(cale, exist_ok=True) sau Path(cale).mkdir(parents=True, exist_ok=True).
  • Scrie scripturile astfel încât să poată fi rulate de mai multe ori la rând fără erori.
  • Folosește modul "x" doar când chiar vrei să eviți suprascrierea, și prinde FileExistsError.

Întrebări frecvente

Nu e mai simplu să verific cu os.path.exists înainte?

Merge, dar între verificare și creare un alt proces poate crea același director. exist_ok=True face totul într-un singur pas și e varianta recomandată.

Ce se întâmplă dacă există un fișier (nu un director) cu același nume?

os.makedirs(..., exist_ok=True) dă tot FileExistsError, pentru că pe acea cale e un fișier, nu un director. Redenumește sau șterge fișierul.

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.