java.lang.IllegalArgumentException: Invalid UUID string: abc-123
UUID.fromString a primit un text care nu are forma unui UUID (32 de cifre hexazecimale în grupuri 8-4-4-4-12, separate prin cratimă). Validează ID-ul primit și tratează IllegalArgumentException, sau curăță textul (trim, fără acolade) înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un UUID are forma 123e4567-e89b-12d3-a456-426614174000: 36 de caractere, cinci grupuri de cifre hexazecimale (0–9, a–f) separate prin cratimă. UUID.fromString acceptă doar această formă, iar pentru orice altceva aruncă IllegalArgumentException:
Invalid UUID string: abc-123când formatul e greșit (prea puține grupuri, litere care nu sunt hexazecimale, lipsesc cratimele);UUID string too largecând textul are peste 36 de caractere, de exemplu cu spații, acolade ({...}) sau ghilimele în plus.
În aplicațiile web apare când un ID din URL sau din JSON e greșit, trunchiat sau e alt tip de ID (un număr, un slug). Fiind o eroare de date de la utilizator, nu de cod, trebuie tratată: un răspuns „ID invalid” (de obicei HTTP 400), nu o excepție necontrolată.
De ce apare: cauzele frecvente
1ID primit de la utilizator, nevalidat
UUID id = UUID.fromString(parametruDinUrl);try {
UUID id = UUID.fromString(parametruDinUrl);
} catch (IllegalArgumentException e) {
System.out.println("ID invalid");
}Datele din exterior pot fi greșite. Le tratezi explicit, cu un mesaj clar.
2Spații sau acolade în jurul ID-ului
UUID id = UUID.fromString(" {123e4567-e89b-12d3-a456-426614174000} ");String curat = text.trim().replace("{", "").replace("}", "");
UUID id = UUID.fromString(curat);Unele sisteme (de exemplu cele Microsoft) afișează UUID-urile între acolade. Le scoți înainte de conversie.
3UUID salvat fără cratime
UUID id = UUID.fromString("123e4567e89b12d3a456426614174000");String s = "123e4567e89b12d3a456426614174000";
String cuCratime = s.replaceFirst("(.{8})(.{4})(.{4})(.{4})(.{12})", "$1-$2-$3-$4-$5");
UUID id = UUID.fromString(cuCratime);Forma fără cratime e frecventă în baze de date. O readuci la forma standard înainte de fromString.
Repară eroarea, direct în pagină
Programul încarcă comenzi după ID-ul din URL, iar un ID greșit îl oprește cu IllegalArgumentException: Invalid UUID string: abc-123. Tratează ID-urile invalide, ca programul să afișeze Comanda 123e4567-e89b-12d3-a456-426614174000 gasita și ID invalid: abc-123.
import java.util.*;
public class Main {
static void incarca(String idDinUrl) {
UUID id = UUID.fromString(idDinUrl);
System.out.println("Comanda " + id + " gasita");
}
public static void main(String[] args) {
incarca("123e4567-e89b-12d3-a456-426614174000");
incarca("abc-123");
}
}Comanda 123e4567-e89b-12d3-a456-426614174000 gasita ID invalid: abc-123
Indiciu
Prinde IllegalArgumentException în jurul lui UUID.fromString și afișează mesajul pentru ID invalid.
Reparația
import java.util.*;
public class Main {
static void incarca(String idDinUrl) {
try {
UUID id = UUID.fromString(idDinUrl);
System.out.println("Comanda " + id + " gasita");
} catch (IllegalArgumentException e) {
System.out.println("ID invalid: " + idDinUrl);
}
}
public static void main(String[] args) {
incarca("123e4567-e89b-12d3-a456-426614174000");
incarca("abc-123");
}
}De ce merge
Primul text are forma standard a unui UUID (8-4-4-4-12 cifre hexazecimale), deci se convertește. abc-123 nu are cele cinci grupuri, iar fromString aruncă IllegalArgumentException. Fiindcă ID-ul vine de la utilizator, excepția e prinsă și transformată într-un mesaj clar, iar programul continuă.
Alte forme ale mesajului
java.lang.IllegalArgumentException: UUID string too largejava.lang.IllegalArgumentException: Invalid UUID string: 123e4567e89b12d3a456426614174000
Cum o eviți pe viitor
- Tratează orice ID primit din exterior ca posibil invalid:
try/catchsau validare cu regex înainte. - În Spring, declară parametrul direct ca
UUID; framework-ul răspunde automat cu 400 la un text invalid. - Păstrează UUID-urile într-un singur format peste tot (cu cratime, litere mici).
- Fă
trim()pe textele citite din fișiere și formulare.
Întrebări frecvente
Literele mari sunt acceptate?
Da, fromString acceptă și A–F mari. toString() scrie însă mereu cu litere mici, așa că la comparații de text folosește tot obiecte UUID, nu șiruri.
Cum generez un UUID nou?
Cu UUID.randomUUID(). Valoarea e aleatoare, deci diferită la fiecare apel.
Erori înrudite
java.lang.NumberFormatException: For input string: "12a" Integer.parseInt (sau Double.parseDouble) a primit un text care nu e un număr valid: litere, spații, virgulă zecimală sau un șir gol. Curăță textul (trim, înlocuiește virgula) și prinde NumberFormatException când datele vin de la utilizator. java.lang.IllegalArgumentException: No enum constant Main.Marime.mediu Enum.valueOf(text) a primit un text care nu e exact numele unei constante: altă literă mare/mică ("mediu" în loc de "MEDIU"), spații sau o valoare necunoscută. Normalizează textul (trim().toUpperCase()) și prinde excepția pentru valorile invalide. java.net.URISyntaxException: Illegal character in query at index 27: https://site.ro/cauta?q=ana maria Adresa dată lui new URI(...) sau URI.create conține caractere nepermise neencodate, de obicei spații, diacritice sau |, în query ori în cale. Encodează valorile cu URLEncoder.encode(valoare, StandardCharsets.UTF_8) înainte să le pui în URL. Î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.
