...
Eroare Java · Fluxuri I/O, codificări și compresie

java.lang.IllegalArgumentException: Malformed \uxxxx encoding.

Pe scurt

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 (\u sau \d scrise 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

Greșit
JAVA
# config.properties
export.cale=C:\users\ana\rapoarte
Corect
JAVA
# config.properties
export.cale=C:/users/ana/rapoarte

Java acceptă / în căi și pe Windows. Fără \, nu mai există secvențe de escape.

2Backslash dublat

Greșit
JAVA
server.share=\\fileserver\update
Corect
JAVA
server.share=\\\\fileserver\\update

În .properties, \\ înseamnă un singur backslash, deci valoarea citită este \\fileserver\update.

3Escape Unicode incomplet

Greșit
JAVA
mesaj.salut=Bun\u0103 ziua, \u21 prieteni
Corect
JAVA
mesaj.salut=Bună ziua, prieteni

Din Java 9, fișierele de resurse pot fi în UTF-8, deci poți scrie diacriticele direct, fără \u.

Repară tu

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.

Codul care dă eroarea
JAVA
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"));
    }
}
După reparație, programul afișează
Export: C:/users/ana/rapoarte
Indiciu

În textul de configurare, înlocuiește fiecare backslash cu /.

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

← Toate erorile Java

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ță 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.