...
Eroare Kotlin · Biblioteca standard, Java și formatare

java.lang.IllegalArgumentException: Invalid UUID string: comanda-125

Pe scurt

UUID.fromString() a primit un text care nu are forma unui UUID (8-4-4-4-12 cifre hexazecimale, de exemplu 123e4567-e89b-12d3-a456-426614174000). Verifică de unde vine valoarea și validează-o înainte; un id numeric sau un cod de comandă nu e UUID.

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

Ce înseamnă

Un UUID are 36 de caractere: 32 de cifre hexazecimale (0-9, a-f) în cinci grupuri de 8, 4, 4, 4 și 12, despărțite de cratime. UUID.fromString(text) aruncă IllegalArgumentException: Invalid UUID string: ... dacă textul nu are cinci grupuri, conține alte caractere sau e gol, iar mesajul include chiar textul primit.

Apare des la API-uri: un endpoint ca /comenzi/{id} așteaptă UUID, dar clientul trimite un id numeric (125), un cod (comanda-125), un text gol sau un UUID cu spații ori ghilimele în plus. Apare și când o coloană din baza de date se schimbă din INT în UUID, dar o parte din cod trimite încă vechile id-uri.

Atenție: fromString e uneori permisivă cu grupurile mai scurte în versiunile vechi de Java, deci nu te baza pe ea ca validator complet.

De ce apare: cauzele frecvente

1Id numeric în loc de UUID

Greșit
KOTLIN
val id = UUID.fromString("125")
Corect
KOTLIN
val id = UUID.fromString("123e4567-e89b-12d3-a456-426614174000")

Doar un text cu forma 8-4-4-4-12 poate fi transformat în UUID.

2Spații sau ghilimele în plus

Greșit
KOTLIN
val id = UUID.fromString(" 123e4567-e89b-12d3-a456-426614174000")
Corect
KOTLIN
val id = UUID.fromString(text.trim().trim('"'))

Curăță valorile venite din formulare, CSV sau JSON înainte de conversie.

3Input nevalidat de la utilizator

Greșit
KOTLIN
fun comanda(idText: String) = repo.gaseste(UUID.fromString(idText))
Corect
KOTLIN
fun comanda(idText: String): Comanda? {
    val id = runCatching { UUID.fromString(idText) }.getOrNull() ?: return null
    return repo.gaseste(id)
}

Un id invalid primit din exterior se tratează ca „negăsit” sau cerere greșită, nu ca o cădere a programului.

Repară tu

Repară eroarea, direct în pagină

Programul încearcă să transforme codul „comanda-125” în UUID și se oprește cu Invalid UUID string: comanda-125. Folosește în locul lui UUID-ul real al comenzii, 123e4567-e89b-12d3-a456-426614174000, ca programul să afișeze Comanda: 123e4567-e89b-12d3-a456-426614174000.

Codul care dă eroarea
KOTLIN
import java.util.UUID

fun main() {
    val id = UUID.fromString("comanda-125")
    println("Comanda: $id")
}
După reparație, programul afișează
Comanda: 123e4567-e89b-12d3-a456-426614174000
Indiciu

fromString cere un text cu forma 8-4-4-4-12 cifre hexazecimale.

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalArgumentException: Invalid UUID string: comanda-125
  • java.lang.IllegalArgumentException: Invalid UUID string:
  • java.lang.IllegalArgumentException: UUID string too large

Cum o eviți pe viitor

Convertește id-urile primite din exterior într-un singur loc (controller, parser) și răspunde cu o eroare 400 clară când textul nu e UUID. Generează id-uri noi cu UUID.randomUUID(), nu le compune manual. Ține același tip de id în tot sistemul și, în Kotlin, poți să-l învelești într-o value class (ComandaId(val uuid: UUID)).

Întrebări frecvente

Cum generez un UUID nou?

Cu UUID.randomUUID(), care produce un UUID aleatoriu (versiunea 4). toString() îl transformă în forma cu cratime.

Contează literele mari sau mici?

Nu, fromString acceptă ambele; toString() întoarce mereu litere mici.

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.