...
Eroare Kotlin · Fișiere, rețea și fire de execuție

kotlin.io.FileAlreadyExistsException: raport.txt -> copie.txt: The destination file already exists.

Pe scurt

File.copyTo nu suprascrie implicit un fișier existent. Dacă vrei să-l înlocuiești, apelează copyTo(destinatie, overwrite = true); altfel alege alt nume sau verifică înainte cu exists().

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

Ce înseamnă

File.copyTo(destinatie) din Kotlin copiază un fișier, dar are overwrite = false implicit: dacă destinația există deja, aruncă kotlin.io.FileAlreadyExistsException, cu ambele căi în mesaj (sursa -> destinatie) și motivul The destination file already exists.. Comportamentul e intenționat, ca să nu pierzi date din greșeală.

Varianta Java, Files.copy(sursa, destinatie), aruncă java.nio.file.FileAlreadyExistsException: copie.txt și se rezolvă cu StandardCopyOption.REPLACE_EXISTING. Tot FileAlreadyExistsException primești la Files.createFile sau Files.createDirectory pe o cale existentă.

Eroarea apare tipic la a doua rulare a unui program: prima a creat fișierul, a doua îl găsește deja acolo.

De ce apare: cauzele frecvente

1A doua rulare a unui export

Greșit
KOTLIN
raport.copyTo(File("backup/raport.txt"))
Corect
KOTLIN
raport.copyTo(File("backup/raport.txt"), overwrite = true)

Cu overwrite = true copia nouă o înlocuiește pe cea veche.

2Copie cu Files.copy

Greșit
KOTLIN
Files.copy(sursa, destinatie)
Corect
KOTLIN
Files.copy(sursa, destinatie, StandardCopyOption.REPLACE_EXISTING)

În API-ul Java, suprascrierea se cere cu opțiunea REPLACE_EXISTING.

3Backup-uri care nu trebuie suprascrise

Greșit
KOTLIN
raport.copyTo(File("backup/raport.txt"))
Corect
KOTLIN
raport.copyTo(File("backup/raport-${LocalDate.now()}.txt"))

Un nume unic (de exemplu cu data) păstrează și copiile vechi.

Repară tu

Repară eroarea, direct în pagină

Programul copiază raport.txt peste copie.txt, care există deja cu o versiune veche, și se oprește cu FileAlreadyExistsException: ... The destination file already exists.. Cere explicit suprascrierea ca programul să afișeze conținutul nou, vanzari: 120.

Codul care dă eroarea
KOTLIN
import java.io.File
import kotlin.io.path.createTempDirectory

fun main() {
    val dir = createTempDirectory().toFile()
    val raport = File(dir, "raport.txt")
    raport.writeText("vanzari: 120")
    val copie = File(dir, "copie.txt")
    copie.writeText("versiune veche")
    raport.copyTo(copie)
    println(copie.readText())
}
După reparație, programul afișează
vanzari: 120
Indiciu

copyTo are un parametru overwrite, false implicit.

Alte forme ale mesajului

  • Exception in thread "main" kotlin.io.FileAlreadyExistsException: raport.txt -> copie.txt: The destination file already exists.
  • java.nio.file.FileAlreadyExistsException: copie.txt
  • java.nio.file.FileAlreadyExistsException: /tmp/rapoarte

Cum o eviți pe viitor

Decide pentru fiecare scriere de fișier ce trebuie să se întâmple dacă există deja: suprascriere (overwrite = true), nume nou sau oprire cu mesaj clar. Pentru directoare folosește Files.createDirectories sau File.mkdirs(), care nu aruncă dacă directorul există. Testează programul rulându-l de două ori la rând.

Întrebări frecvente

De ce copyTo nu suprascrie implicit?

Ca să nu distrugi din greșeală un fișier important. Suprascrierea trebuie cerută explicit, ca să fie vizibilă în cod.

writeText suprascrie?

Da, File.writeText înlocuiește conținutul fără să întrebe. Doar funcțiile de copiere și creare verifică existența destinației.

Erori înrudite

← Toate erorile Kotlin

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ță Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.