...
Eroare Java · Reflecție, module și alte API-uri

java.lang.IllegalArgumentException: Invalid UUID string: abc-123

Pe scurt

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-123 când formatul e greșit (prea puține grupuri, litere care nu sunt hexazecimale, lipsesc cratimele);
  • UUID string too large câ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

Greșit
JAVA
UUID id = UUID.fromString(parametruDinUrl);
Corect
JAVA
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

Greșit
JAVA
UUID id = UUID.fromString(" {123e4567-e89b-12d3-a456-426614174000} ");
Corect
JAVA
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

Greșit
JAVA
UUID id = UUID.fromString("123e4567e89b12d3a456426614174000");
Corect
JAVA
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ă tu

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.

Codul care dă eroarea
JAVA
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");
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: UUID string too large
  • java.lang.IllegalArgumentException: Invalid UUID string: 123e4567e89b12d3a456426614174000

Cum o eviți pe viitor

  • Tratează orice ID primit din exterior ca posibil invalid: try/catch sau 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

← 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.