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

java.net.URISyntaxException: Illegal character in query at index 31: https://example.com/cauta?q=pix albastru

Pe scurt

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

Greșit
KOTLIN
import java.net.URI

fun main() {
    val termen = "pix albastru"
    println(URI("https://magazin.ro/cauta?q=$termen").query)
}
Corect
KOTLIN
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

Greșit
KOTLIN
import java.net.URI

fun main() {
    println(URI("https://cdn.ro/poze/produs nou.jpg").path)
}
Corect
KOTLIN
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ă tu

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.

Codul care dă eroarea
KOTLIN
import java.net.URI

fun main() {
    val termen = "casti wireless"
    val uri = URI("https://magazin.ro/cauta?q=$termen")
    println("Query: ${uri.rawQuery}")
}
După reparație, programul afișează
Query: q=casti+wireless
Indiciu

val q = URLEncoder.encode(termen, Charsets.UTF_8), apoi folosește q în URL; afișează rawQuery.

Alte forme ale mesajului

  • Exception in thread "main" java.net.URISyntaxException: Illegal character in query at index 31: https://example.com/cauta?q=pix albastru
  • java.net.URISyntaxException: Illegal character in path at index 22: https://cdn.ro/poze/produs nou.jpg
  • java.net.URISyntaxException: Illegal character in authority at index 8: http://a b.ro
  • java.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

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