java.lang.IllegalArgumentException: Invalid UUID string: comanda-125
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
val id = UUID.fromString("125")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
val id = UUID.fromString(" 123e4567-e89b-12d3-a456-426614174000")val id = UUID.fromString(text.trim().trim('"'))Curăță valorile venite din formulare, CSV sau JSON înainte de conversie.
3Input nevalidat de la utilizator
fun comanda(idText: String) = repo.gaseste(UUID.fromString(idText))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ă 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.
import java.util.UUID
fun main() {
val id = UUID.fromString("comanda-125")
println("Comanda: $id")
}Comanda: 123e4567-e89b-12d3-a456-426614174000
Indiciu
fromString cere un text cu forma 8-4-4-4-12 cifre hexazecimale.
Reparația
import java.util.UUID
fun main() {
val id = UUID.fromString("123e4567-e89b-12d3-a456-426614174000")
println("Comanda: $id")
}De ce merge
„comanda-125” este un cod de comandă, nu un UUID: nu are cele cinci grupuri de cifre hexazecimale cerute. UUID.fromString acceptă doar forma standard, cu 36 de caractere. Cu UUID-ul real, conversia reușește, iar toString() (folosit în string template) îl afișează în aceeași formă.
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalArgumentException: Invalid UUID string: comanda-125java.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
java.lang.NumberFormatException: For input string: "abc" Ai apelat toInt() (sau toDouble(), toLong()) pe un text care nu e un număr valid: "abc", "12.5" pentru Int, "" sau " 7" cu spații. Folosește toIntOrNull() și tratează null, sau curăță textul înainte (trim()). java.lang.IllegalArgumentException: No enum constant Status.livrat Ai apelat valueOf("...") pe o enum cu un text care nu e exact numele unei constante (diferă literele mari/mici, are spații sau e o valoare nouă). Normalizează textul (trim().uppercase()) sau caută sigur: entries.find { it.name == text } ?: valoare implicită. java.lang.IllegalArgumentException: Failed requirement. O verificare require(...) din cod a primit false: o funcție a fost apelată cu un argument invalid (o sumă negativă, o listă goală). Repară apelul ca să trimită date valide sau tratează cazul înainte de apel. Pune un mesaj în require ca eroarea să spună ce e greșit. Î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.
