java.net.URISyntaxException: Illegal character in query at index 31: https://example.com/cauta?q=pix albastru
URL-ul conține un caracter nepermis neencodat, cel mai des un spațiu, diacritice sau &, # în valorile parametrilor. Encodează valorile cu URLEncoder.encode(text, Charsets.UTF_8) înainte să le pui în URL (pix albastru devine pix+albastru).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
java.net.URI respectă strict standardul: într-un URL nu pot exista spații, ghilimele, <, >, {, | și nici caractere non-ASCII neencodate. Mesajul spune ce parte a URL-ului e greșită (in path, in query, in authority), poziția caracterului (at index 31, de la 0) și tot textul primit.
Cel mai des, problema e o valoare introdusă de utilizator pusă direct în URL: un termen de căutare cu spații, un nume cu diacritice, un parametru care conține & sau =. Soluția este encodarea fiecărei valori cu URLEncoder.encode(valoare, Charsets.UTF_8), care transformă spațiul în + și caracterele speciale în %XX.
Aceeași problemă apare la clienți HTTP (OkHttp, Ktor, Retrofit) cu mesaje proprii, de exemplu IllegalArgumentException: Illegal character in query.
De ce apare: cauzele frecvente
1Termen de căutare cu spații
import java.net.URI
fun main() {
val termen = "pix albastru"
println(URI("https://magazin.ro/cauta?q=$termen").query)
}import java.net.URI
import java.net.URLEncoder
fun main() {
val termen = URLEncoder.encode("pix albastru", Charsets.UTF_8)
println(URI("https://magazin.ro/cauta?q=$termen").rawQuery)
}După encodare, URL-ul conține q=pix+albastru, care e valid.
2Spațiu în cale
import java.net.URI
fun main() {
println(URI("https://cdn.ro/poze/produs nou.jpg").path)
}import java.net.URI
fun main() {
println(URI("https", "cdn.ro", "/poze/produs nou.jpg", null).rawPath)
}Constructorul cu componente separate encodează singur calea (produs%20nou.jpg).
Repară eroarea, direct în pagină
Programul de mai jos construiește URL-ul unei căutări din textul introdus de utilizator, dar se oprește cu java.net.URISyntaxException: Illegal character in query. Encodează termenul de căutare (cu URLEncoder.encode și Charsets.UTF_8) înainte să-l pui în URL, ca programul să afișeze Query: q=casti+wireless.
import java.net.URI
fun main() {
val termen = "casti wireless"
val uri = URI("https://magazin.ro/cauta?q=$termen")
println("Query: ${uri.rawQuery}")
}Query: q=casti+wireless
Indiciu
val q = URLEncoder.encode(termen, Charsets.UTF_8), apoi folosește q în URL; afișează rawQuery.
Reparația
import java.net.URI
import java.net.URLEncoder
fun main() {
val termen = "casti wireless"
val q = URLEncoder.encode(termen, Charsets.UTF_8)
val uri = URI("https://magazin.ro/cauta?q=$q")
println("Query: ${uri.rawQuery}")
}De ce merge
Spațiul nu e permis într-un URL, deci URI refuză textul și indică poziția lui în query. URLEncoder.encode transformă spațiul în + (și orice caracter special în %XX), iar URL-ul rezultat e valid. rawQuery afișează partea de query exact cum apare în URL, adică q=casti+wireless.
Alte forme ale mesajului
Exception in thread "main" java.net.URISyntaxException: Illegal character in query at index 31: https://example.com/cauta?q=pix albastrujava.net.URISyntaxException: Illegal character in path at index 22: https://cdn.ro/poze/produs nou.jpgjava.net.URISyntaxException: Illegal character in authority at index 8: http://a b.rojava.lang.IllegalArgumentException: Illegal character in query at index 31
Cum o eviți pe viitor
Nu lipi niciodată valori de la utilizator direct într-un URL. Encodează fiecare parametru cu URLEncoder.encode(..., Charsets.UTF_8) sau, mai bine, lasă biblioteca HTTP să construiască URL-ul (HttpUrl.Builder().addQueryParameter("q", termen) în OkHttp, parameter("q", termen) în Ktor). Encodarea se aplică doar valorilor, nu întregului URL.
Întrebări frecvente
URLEncoder transformă spațiul în + sau în %20?
În +, ca în formularele HTML, corect pentru parametrii din query. În cale (path), spațiul trebuie să fie %20; acolo folosește constructorul URI cu componente separate sau un builder HTTP.
Diacriticele trebuie encodate?
Da. URLEncoder.encode("ș", Charsets.UTF_8) dă %C8%99. Browserul îți arată adresa „frumos”, dar pe rețea circulă forma encodată.
Erori înrudite
java.net.MalformedURLException: no protocol: example.com/api Ai creat un URL fără schemă la început (example.com/api în loc de https://example.com/api) sau cu un text gol. Clasa URL cere protocolul. Adaugă https:// (sau http://), iar dacă adresa vine din configurare, verific-o și curăț-o (trim) înainte. Unsupported escape sequence Într-un string ai un backslash urmat de o literă pe care Kotlin nu o cunoaște ca secvență specială, de obicei într-o cale Windows ("C:\date"). Dublează backslash-ul ("C:\\date") sau folosește un raw string cu ghilimele triple ("""C:\date"""). 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()). Î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.
