java.net.URISyntaxException: Illegal character in query at index 27: https://site.ro/cauta?q=ana maria
Adresa dată lui new URI(...) sau URI.create conține caractere nepermise neencodate, de obicei spații, diacritice sau |, în query ori în cale. Encodează valorile cu URLEncoder.encode(valoare, StandardCharsets.UTF_8) înainte să le pui în URL.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un URI are reguli stricte: spațiile, ghilimelele, |, { }, <> și caracterele non-ASCII (diacriticele) nu au voie să apară direct, ci doar encodate (spațiul devine %20 sau +, „ș” devine %C8%99). Când new URI(text) găsește un astfel de caracter, aruncă URISyntaxException și îți spune unde: Illegal character in query at index 27, adică în partea de după ?, la poziția 27 din text (numărând de la 0). Variantele: in path (în cale), in fragment (după #), in authority (în domeniu).
Excepția e verificată la new URI. URI.create aruncă în schimb IllegalArgumentException cu același mesaj în interior. Apare frecvent când construiești URL-uri pentru API-uri prin concatenare cu texte de la utilizator, de exemplu termeni de căutare. Clientul HTTP din Java (HttpRequest.newBuilder(URI)) dă aceeași eroare.
De ce apare: cauzele frecvente
1Termen de căutare cu spațiu, neencodat
String q = "ana maria";
URI uri = new URI("https://site.ro/cauta?q=" + q);String q = URLEncoder.encode("ana maria", StandardCharsets.UTF_8);
URI uri = new URI("https://site.ro/cauta?q=" + q);URLEncoder.encode transformă spațiul în + și diacriticele în coduri %XX, permise în query.
2Spațiu sau diacritice în cale
URI uri = new URI("https://site.ro/produse/cafea boabe");URI uri = new URI("https", "site.ro", "/produse/cafea boabe", null);
// devine https://site.ro/produse/cafea%20boabeConstructorul cu mai multe părți encodează singur caracterele nepermise din cale.
3Caractere speciale lipite din alte surse
URI uri = URI.create("https://api.site.ro/filtre?tag=java|spring");String tag = URLEncoder.encode("java|spring", StandardCharsets.UTF_8);
URI uri = URI.create("https://api.site.ro/filtre?tag=" + tag);| nu e permis direct într-un URI; encodat devine %7C.
Repară eroarea, direct în pagină
Programul construiește adresa unei căutări pe site din termenul introdus de utilizator, dar se oprește cu URISyntaxException: Illegal character in query. Encodează termenul, ca programul să afișeze Cerere: https://site.ro/cauta?q=ana+maria și Parametru: q=ana+maria.
import java.net.*;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws URISyntaxException {
String termen = "ana maria";
URI cerere = new URI("https://site.ro/cauta?q=" + termen);
System.out.println("Cerere: " + cerere);
System.out.println("Parametru: " + cerere.getRawQuery());
}
}Cerere: https://site.ro/cauta?q=ana+maria Parametru: q=ana+maria
Indiciu
Trece termenul prin URLEncoder.encode(termen, StandardCharsets.UTF_8) înainte de concatenare.
Reparația
import java.net.*;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws URISyntaxException {
String termen = URLEncoder.encode("ana maria", StandardCharsets.UTF_8);
URI cerere = new URI("https://site.ro/cauta?q=" + termen);
System.out.println("Cerere: " + cerere);
System.out.println("Parametru: " + cerere.getRawQuery());
}
}De ce merge
Spațiul nu e permis direct într-un URI, iar new URI l-a găsit în query, după q=. URLEncoder.encode transformă termenul în forma permisă (ana+maria), iar adresa devine validă. Am encodat doar valoarea, nu tot URL-ul, ca ? și = să-și păstreze rolul.
Alte forme ale mesajului
java.net.URISyntaxException: Illegal character in path at index 29: https://site.ro/produse/cafea boabejava.lang.IllegalArgumentException: Illegal character in query at index 27: https://site.ro/cauta?q=ana mariajava.net.URISyntaxException: Illegal character in authority at index 8: https://site ro/java.net.URISyntaxException: Expected scheme-specific part at index 6: https:
Cum o eviți pe viitor
- Nu construi URL-uri prin concatenare cu valori brute: encodează fiecare valoare cu
URLEncoder.encode(v, StandardCharsets.UTF_8). - Encodează doar valorile, nu tot URL-ul:
?,&și=trebuie să rămână neschimbate. - În Spring, folosește
UriComponentsBuilder, care encodează corect fiecare parte. - Fă
trim()pe URL-urile citite din configurări, ca să nu rămână spații la capete.
Întrebări frecvente
De ce URLEncoder pune + în loc de %20?
URLEncoder urmează formatul formularelor HTML, unde spațiul din query devine +. Serverele îl înțeleg corect în query. În cale (path), spațiul trebuie să fie %20, de aceea acolo folosești constructorul URI cu mai multe părți.
Cum citesc index-ul din mesaj?
Numără caracterele din adresa afișată, de la 0. Caracterul de la acea poziție e primul nepermis, de obicei un spațiu.
Erori înrudite
java.lang.IllegalArgumentException: Invalid UUID string: abc-123 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. error: unreported exception Exception; must be caught or declared to be thrown Apelezi o metodă care poate arunca o excepție verificată (checked), iar codul tău nici nu o prinde, nici nu o declară. Pune apelul într-un try/catch sau adaugă throws NumeExceptie la metoda care face apelul. error: illegal character: '\u201c' În cod ai ghilimele „inteligente” (“ ” sau „ ”) în loc de ghilimele drepte ". Se întâmplă când copiezi cod din Word, dintr-un PDF sau de pe un site. Înlocuiește-le cu " și eroarea dispare. Î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.
