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().
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://
URL url = new URL("www.site.ro/api");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ă
URL url = URI.create("/api/produse").toURL();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
URL url = URI.create(" https://www.site.ro").toURL();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ă 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.
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());
}
}Host: www.site.ro, cale: /api
Indiciu
Adresa trebuie să înceapă cu https://; folosește URI.create(adresa).toURL().
Reparația
import java.net.URI;
import java.net.URL;
public class Main {
public static void main(String[] args) throws Exception {
String adresa = "https://www.site.ro/api";
URL url = URI.create(adresa).toURL();
System.out.println("Host: " + url.getHost() + ", cale: " + url.getPath());
}
}De ce merge
Fără protocol, Java nu știe cum să interpreteze textul și nu poate construi un URL. Cu https:// în față, URI.create recunoaște schema, host-ul și calea, iar toURL() produce URL-ul fără constructorul depreciat. getHost() și getPath() citesc apoi părțile adresei. Programul nu face nicio conexiune la rețea.
Alte forme ale mesajului
java.net.MalformedURLException: no protocol: localhost:8080/apijava.lang.IllegalArgumentException: URI is not absolutejava.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://sauhttps://, afișează un mesaj sau adaugă protocolul explicit. - Folosește
URI.create(...).toURL()în loc de constructorii depreciaținew 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
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: 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. java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver Java a căutat la rulare o clasă după nume (Class.forName, un driver JDBC, un framework) și n-a găsit-o în classpath. De obicei lipsește biblioteca (driverul MySQL / PostgreSQL) din dependențe sau numele clasei e scris greșit. Adaugă dependența sau corectează numele complet. Î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.
