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

java.net.MalformedURLException: no protocol: www.site.ro/api

Pe scurt

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().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un URL complet are întâi protocolul (https, http, file, jar), apoi :// și restul adresei. Browserul completează singur https:// când scrii www.site.ro, dar Java nu: new URL("www.site.ro/api") aruncă MalformedURLException: no protocol: www.site.ro/api, cu textul primit în mesaj.

Cauze frecvente:

  • adresa vine din configurare sau dintr-un formular fără https://;
  • ai lipit adrese relative (/api/produse) fără adresa de bază;
  • textul are spații sau ghilimele la început, de exemplu " https://..." sau "\"https://...\"" citit dintr-un fișier.

Din Java 20, constructorii new URL(...) sunt depreciați (compilatorul afișează o notă). Varianta recomandată este URI.create(text).toURL() sau new URI(text).toURL(). Pentru o adresă fără protocol, toURL() aruncă IllegalArgumentException: URI is not absolute, aceeași problemă cu alt mesaj.

De ce apare: cauzele frecvente

1Adresa fără https://

Greșit
JAVA
URL url = new URL("www.site.ro/api");
Corect
JAVA
URL url = URI.create("https://www.site.ro/api").toURL();

Cu protocolul în față, adresa e completă și poate fi transformată în URL.

2Cale relativă fără adresa de bază

Greșit
JAVA
URL url = URI.create("/api/produse").toURL();
Corect
JAVA
URI baza = URI.create("https://www.site.ro");
URL url = baza.resolve("/api/produse").toURL();

resolve combină adresa de bază cu calea relativă.

3Spații la începutul textului

Greșit
JAVA
URL url = URI.create(" https://www.site.ro").toURL();
Corect
JAVA
URL url = URI.create(" https://www.site.ro".trim()).toURL();

Un spațiu în față face ca protocolul să nu mai fie recunoscut (sau dă URISyntaxException).

Repară tu

Repară eroarea, direct în pagină

Programul construiește adresa unui API din configurare, dar adresa nu are protocol și programul se oprește cu MalformedURLException: no protocol: www.site.ro/api. Folosește adresa completă și construiește URL-ul prin URI.create(...).toURL(), ca programul să afișeze Host: www.site.ro, cale: /api.

Codul care dă eroarea
JAVA
import java.net.URL;

public class Main {
    public static void main(String[] args) throws Exception {
        String adresa = "www.site.ro/api";
        URL url = new URL(adresa);
        System.out.println("Host: " + url.getHost() + ", cale: " + url.getPath());
    }
}
După reparație, programul afișează
Host: www.site.ro, cale: /api
Indiciu

Adresa trebuie să înceapă cu https://; folosește URI.create(adresa).toURL().

Alte forme ale mesajului

  • java.net.MalformedURLException: no protocol: localhost:8080/api
  • java.lang.IllegalArgumentException: URI is not absolute
  • java.net.MalformedURLException: unknown protocol: htps

Cum o eviți pe viitor

  • Păstrează în configurare adresa de bază completă, cu protocol: https://api.site.ro.
  • Construiește adresele cu URI.resolve, nu prin lipire de texte.
  • Validează adresele primite de la utilizator: dacă nu încep cu http:// sau https://, afișează un mesaj sau adaugă protocolul explicit.
  • Folosește URI.create(...).toURL() în loc de constructorii depreciați new URL(...).

Întrebări frecvente

De ce compilatorul afișează o notă despre deprecated?

Din Java 20, constructorii URL(String) sunt depreciați, pentru că acceptau adrese ambigue. Codul încă rulează, dar e recomandat să treci la URI.create(...).toURL().

Care e diferența dintre URI și URL?

URI doar descrie și validează o adresă. URL e folosit pentru a deschide conexiuni. Construiești întâi URI-ul, apoi îl transformi în URL când ai nevoie.

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.