java.net.MalformedURLException: no protocol: example.com/api
Ai creat un URL fără schemă la început (example.com/api în loc de https://example.com/api) sau cu un text gol. Clasa URL cere protocolul. Adaugă https:// (sau http://), iar dacă adresa vine din configurare, verific-o și curăț-o (trim) înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
java.net.URL (folosit direct sau de biblioteci mai vechi) cere un URL absolut, cu protocol: https://, http://, file:, jar:. Textul example.com/api arată ca o adresă, dar fără schemă nu se știe cum să fie accesat, așa că constructorul aruncă MalformedURLException: no protocol: ... și afișează textul primit.
Cazuri tipice:
- adresa serverului e scrisă în configurare fără
https://; - variabila e goală (
no protocol:urmat de nimic) pentru că setarea lipsește; - URL-ul are spații sau ghilimele la început, copiate dintr-un fișier;
- concatenezi un URL relativ (
/api/produse) fără baza serverului.
Pentru un protocol necunoscut mesajul este unknown protocol: htps.
De ce apare: cauzele frecvente
1Adresă fără https://
import java.net.URL
fun main() {
val u = URL("api.magazin.ro/produse")
println(u.host)
}import java.net.URI
fun main() {
val u = URI("https://api.magazin.ro/produse").toURL()
println(u.host)
}Cu protocolul prezent, URL-ul e absolut. URI(...).toURL() e forma recomandată în Java 20+.
2Cale relativă fără baza serverului
import java.net.URL
fun main() {
val u = URL("/api/comenzi")
println(u)
}import java.net.URI
fun main() {
val baza = URI("https://api.magazin.ro/")
println(baza.resolve("/api/comenzi"))
}resolve combină corect baza cu calea relativă.
Repară eroarea, direct în pagină
Programul de mai jos citește domeniul unui API dintr-o adresă din configurare, dar adresa n-are protocolul și programul se oprește cu java.net.MalformedURLException: no protocol: api.magazin.ro/v1. Repară construirea URL-ului (adaugă https:// în fața adresei din configurare) ca programul să afișeze Server: api.magazin.ro, cale: /v1.
import java.net.URL
fun main() {
val adresaConfig = "api.magazin.ro/v1"
val url = URL(adresaConfig)
println("Server: ${url.host}, cale: ${url.path}")
}Server: api.magazin.ro, cale: /v1
Indiciu
Construiește textul "https://" + adresa înainte să creezi URL-ul.
Reparația
import java.net.URL
fun main() {
val adresaConfig = "api.magazin.ro/v1"
val url = URL("https://" + adresaConfig)
println("Server: ${url.host}, cale: ${url.path}")
}De ce merge
Clasa URL cere un URL absolut, care începe cu un protocol. api.magazin.ro/v1 nu are, deci constructorul nu știe ce fel de adresă e. Cu https:// în față, textul devine un URL complet, din care host este api.magazin.ro, iar path este /v1.
Alte forme ale mesajului
Exception in thread "main" java.net.MalformedURLException: no protocol: example.com/apijava.net.MalformedURLException: no protocol:java.net.MalformedURLException: unknown protocol: htpsjava.lang.IllegalArgumentException: URI is not absolute
Cum o eviți pe viitor
Ține URL-ul de bază al serverului într-un singur loc (o constantă sau configurare), complet, cu https://, și construiește restul cu resolve sau cu bibliotecile HTTP (OkHttp, Ktor), care validează adresa. Când URL-ul vine din afară, aplică trim() și verifică începutul (startsWith("https://")) înainte de folosire.
Întrebări frecvente
Constructorul URL(String) e depreciat?
Da, din Java 20 e marcat depreciat, în favoarea URI(text).toURL(), care validează mai strict. Excepția echivalentă de acolo este IllegalArgumentException: URI is not absolute.
De ce browserul acceptă example.com fără https?
Browserul completează singur protocolul. Clasele Java nu ghicesc: textul trebuie să fie un URL complet.
Erori înrudite
java.net.URISyntaxException: Illegal character in query at index 31: https://example.com/cauta?q=pix albastru URL-ul conține un caracter nepermis neencodat, cel mai des un spațiu, diacritice sau &, # în valorile parametrilor. Encodează valorile cu URLEncoder.encode(text, Charsets.UTF_8) înainte să le pui în URL (pix albastru devine pix+albastru). java.io.FileNotFoundException: date.txt (No such file or directory) Fișierul pe care vrei să-l citești nu există la calea dată, de cele mai multe ori pentru că o cale relativă e calculată față de alt folder decât crezi. Verifică directorul curent (File(".").absolutePath), folosește calea completă sau tratează lipsa fișierului cu exists() / try-catch. java.lang.IllegalArgumentException: Failed requirement. O verificare require(...) din cod a primit false: o funcție a fost apelată cu un argument invalid (o sumă negativă, o listă goală). Repară apelul ca să trimită date valide sau tratează cazul înainte de apel. Pune un mesaj în require ca eroarea să spună ce e greșit. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
