java.lang.IllegalArgumentException: URI with undefined scheme
HttpRequest a primit o adresă fără http:// sau https:// la început, deci nu știe ce protocol să folosească. Scrie adresa completă: URI.create("https://www.site.ro/api").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HttpClient din java.net.http (Java 11+) trimite cereri doar prin http și https. Când construiești cererea cu HttpRequest.newBuilder().uri(...), adresa e verificată imediat:
- fără schemă (
www.site.ro/api) primeștiURI with undefined scheme; - cu o schemă pe care nu o suportă (
ftp://...) primeștiinvalid URI scheme ftp; - la
localhost:8080/api, partea dinaintea primelor două puncte e citită drept schemă, deci mesajul devineinvalid URI scheme localhost.
Excepția apare înainte de orice conexiune, deci nu ține de rețea, ci doar de textul adresei. Cel mai des, adresa de bază din configurare nu are protocolul, sau e lipită dintr-o bucată de cale fără adresa de bază.
De ce apare: cauzele frecvente
1Adresa fără https://
HttpRequest r = HttpRequest.newBuilder()
.uri(URI.create("www.site.ro/api/produse"))
.build();HttpRequest r = HttpRequest.newBuilder()
.uri(URI.create("https://www.site.ro/api/produse"))
.build();Cu schema https, clientul știe ce protocol și ce port implicit (443) să folosească.
2localhost fără http://
URI.create("localhost:8080/api")URI.create("http://localhost:8080/api")Fără http://, textul localhost e luat drept schemă. Pentru serverul local scrie mereu protocolul.
3Calea lipită fără adresa de bază
URI.create("/api/produse")URI baza = URI.create("https://www.site.ro");
URI adresa = baza.resolve("/api/produse");resolve combină o adresă de bază completă cu o cale relativă.
Repară eroarea, direct în pagină
Programul pregătește o cerere HTTP către API-ul magazinului, dar adresa nu are protocol și programul se oprește cu IllegalArgumentException: URI with undefined scheme. Adaugă https:// la adresa de bază, ca programul să afișeze GET https://www.site.ro/api/produse.
import java.net.URI;
import java.net.http.HttpRequest;
public class Main {
public static void main(String[] args) {
String baza = "www.site.ro";
HttpRequest cerere = HttpRequest.newBuilder()
.uri(URI.create(baza + "/api/produse"))
.GET()
.build();
System.out.println(cerere.method() + " " + cerere.uri());
}
}GET https://www.site.ro/api/produse
Indiciu
Adresa de bază trebuie să înceapă cu https://.
Reparația
import java.net.URI;
import java.net.http.HttpRequest;
public class Main {
public static void main(String[] args) {
String baza = "https://www.site.ro";
HttpRequest cerere = HttpRequest.newBuilder()
.uri(URI.create(baza + "/api/produse"))
.GET()
.build();
System.out.println(cerere.method() + " " + cerere.uri());
}
}De ce merge
HttpRequest.Builder.uri verifică adresa imediat și acceptă doar schemele http și https. Textul www.site.ro/api/produse nu are schemă, deci e respins. Cu https:// în față, adresa e completă și cererea se construiește. Programul doar o pregătește și o afișează, fără să o trimită.
Alte forme ale mesajului
java.lang.IllegalArgumentException: invalid URI scheme localhostjava.lang.IllegalArgumentException: invalid URI scheme ftp
Cum o eviți pe viitor
- Păstrează în configurare adresa de bază completă (
https://api.site.ro) și construiește restul curesolve. - Validează adresa la pornirea aplicației:
uri.getScheme()trebuie să fiehttpsauhttps. - Pentru serviciile locale, scrie
http://localhost:8080, nu doarlocalhost:8080. - Encodează valorile din query cu
URLEncoder.encode(v, StandardCharsets.UTF_8).
Întrebări frecvente
E aceeași problemă ca MalformedURLException: no protocol?
Da, aceeași cauză: lipsește protocolul. new URL(...) raportează no protocol, iar HttpRequest raportează URI with undefined scheme.
Merge HttpClient și cu ftp:// sau file://?
Nu. HttpClient suportă doar http și https. Pentru fișiere locale folosește java.nio.file, iar pentru FTP o bibliotecă dedicată.
Erori înrudite
java.net.MalformedURLException: no protocol: www.site.ro/api Adresa nu începe cu un protocol, de exemplu https://, așa că Java nu o poate transforma în URL. Scrie adresa completă (https://www.site.ro/api) și, în Java 20+, creeaz-o cu URI.create(...).toURL(). 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. java.lang.IllegalArgumentException: port out of range:70000 Portul trimis la InetSocketAddress, Socket sau ServerSocket nu e între 0 și 65535. De obicei portul din configurare are o cifră în plus sau a fost citit greșit: corectează valoarea (de exemplu 8080) și valideaz-o la citire. Î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.
