...
Eroare Java · Reflecție, module și alte API-uri

java.lang.IllegalArgumentException: URI with undefined scheme

Pe scurt

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ști URI with undefined scheme;
  • cu o schemă pe care nu o suportă (ftp://...) primești invalid URI scheme ftp;
  • la localhost:8080/api, partea dinaintea primelor două puncte e citită drept schemă, deci mesajul devine invalid 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://

Greșit
JAVA
HttpRequest r = HttpRequest.newBuilder()
    .uri(URI.create("www.site.ro/api/produse"))
    .build();
Corect
JAVA
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://

Greșit
JAVA
URI.create("localhost:8080/api")
Corect
JAVA
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ă

Greșit
JAVA
URI.create("/api/produse")
Corect
JAVA
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ă tu

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.

Codul care dă eroarea
JAVA
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());
    }
}
După reparație, programul afișează
GET https://www.site.ro/api/produse
Indiciu

Adresa de bază trebuie să înceapă cu https://.

Alte forme ale mesajului

  • java.lang.IllegalArgumentException: invalid URI scheme localhost
  • java.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 cu resolve.
  • Validează adresa la pornirea aplicației: uri.getScheme() trebuie să fie http sau https.
  • Pentru serviciile locale, scrie http://localhost:8080, nu doar localhost: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

← Toate erorile Java

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ță 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.