java.lang.IllegalArgumentException: Malformed \uxxxx encoding.
Un fișier .properties conține un backslash urmat de u, de exemplu o cale Windows (C:\users\ana), iar Properties.load îl citește ca început de caracter Unicode \uXXXX. Dublează backslash-urile (C:\\users\\ana) sau scrie căile cu / (C:/users/ana).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În fișierele .properties, \ este caracter de escape, ca în Java: \n e rând nou, \t e tab, iar \u0103 înseamnă caracterul ă. Când Properties.load găsește \u, așteaptă exact patru cifre hexazecimale. În cale=C:\users\ana, după \u urmează sers, care nu sunt cifre hex, deci aruncă IllegalArgumentException: Malformed \uxxxx encoding.
Mesajul nu spune cheia sau rândul, așa că trebuie să cauți în fișier fiecare \u. Cel mai des sunt:
- căi Windows (
C:\users,D:\util,\\server\update); - expresii regulate puse în configurare (
\usau\dscrise o singură dată); - texte copiate dintr-un JSON cu escape-uri incomplete.
Backslash-ul simplu urmat de alte litere nu dă eroare, dar dispare la citire (C:\date devine C:date), deci căile sunt oricum greșite.
De ce apare: cauzele frecvente
1Cale Windows cu backslash simplu
# config.properties
export.cale=C:\users\ana\rapoarte# config.properties
export.cale=C:/users/ana/rapoarteJava acceptă / în căi și pe Windows. Fără \, nu mai există secvențe de escape.
2Backslash dublat
server.share=\\fileserver\updateserver.share=\\\\fileserver\\updateÎn .properties, \\ înseamnă un singur backslash, deci valoarea citită este \\fileserver\update.
3Escape Unicode incomplet
mesaj.salut=Bun\u0103 ziua, \u21 prietenimesaj.salut=Bună ziua, prieteniDin Java 9, fișierele de resurse pot fi în UTF-8, deci poți scrie diacriticele direct, fără \u.
Repară eroarea, direct în pagină
Programul încarcă setările aplicației dintr-un text în format .properties, dar calea de export e scrisă cu backslash-uri Windows și programul se oprește cu IllegalArgumentException: Malformed \uxxxx encoding. Scrie calea cu /, ca programul să afișeze Export: C:/users/ana/rapoarte.
import java.io.StringReader;
import java.util.Properties;
public class Main {
public static void main(String[] args) throws Exception {
String config = "aplicatie=magazin\nexport.cale=C:\\users\\ana\\rapoarte\n";
Properties p = new Properties();
p.load(new StringReader(config));
System.out.println("Export: " + p.getProperty("export.cale"));
}
}Export: C:/users/ana/rapoarte
Indiciu
În textul de configurare, înlocuiește fiecare backslash cu /.
Reparația
import java.io.StringReader;
import java.util.Properties;
public class Main {
public static void main(String[] args) throws Exception {
String config = "aplicatie=magazin\nexport.cale=C:/users/ana/rapoarte\n";
Properties p = new Properties();
p.load(new StringReader(config));
System.out.println("Export: " + p.getProperty("export.cale"));
}
}De ce merge
În șirul Java, \\ e un singur backslash, deci textul citit de Properties conține C:\users\ana\rapoarte. Pentru Properties, \u începe un caracter Unicode cu patru cifre hex, iar sers nu sunt cifre hex, de aceea apare excepția. Cu /, nu mai există secvențe de escape, iar Java înțelege calea corect și pe Windows.
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalArgumentException: Malformed \uxxxx encoding. at java.base/java.util.Properties.loadConvert
Cum o eviți pe viitor
- Scrie căile din fișierele de configurare cu
/sau cu\\. - Pentru fișierele de traduceri (
ResourceBundle) folosește UTF-8 și diacriticele direct. - Când citești o configurare, prinde excepția și afișează numele fișierului, ca să știi unde să cauți.
- Pentru configurări complexe (liste, căi, expresii regulate), un format ca YAML sau JSON e mai puțin surprinzător.
Întrebări frecvente
De ce C:\date devine C:date fără nicio eroare?
Pentru că \d nu e o secvență cunoscută, iar Properties elimină pur și simplu backslash-ul. Doar \u are o formă obligatorie, de aceea doar el aruncă excepție.
Am aceeași problemă în codul Java?
Similară: în cod, "C:\users" nu compilează (illegal unicode escape), iar "C:\date" dă illegal escape character. În cod scrii "C:\\users" sau "C:/users".
Erori înrudite
error: illegal escape character Într-un String ai un backslash \ urmat de o literă pe care Java nu o cunoaște ca secvență specială, de obicei într-o cale Windows ("C:\Users") sau într-un regex ("\d"). Scrie backslash-ul dublat: \\. java.util.MissingResourceException: Can't find bundle for base name mesaje, locale en_US ResourceBundle.getBundle nu găsește fișierul de traduceri (mesaje.properties) sau clasa cu numele dat: nume greșit, fișier în alt folder sau lipsă din classpath. Pune mesaje.properties în src/main/resources și folosește exact numele lui, fără extensie. java.nio.charset.UnsupportedCharsetException: UFT-8 Numele codificării dat la Charset.forName (sau la new String, getBytes, InputStreamReader) nu e recunoscut, de obicei din cauza unei greșeli de scriere: UFT-8, UTF_8, "utf 8". Folosește constantele StandardCharsets.UTF_8, care nu pot fi scrise greșit. Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
