...
Eroare Kotlin · Biblioteca standard, Java și formatare

java.net.MalformedURLException: no protocol: example.com/api

Pe scurt

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://

Greșit
KOTLIN
import java.net.URL

fun main() {
    val u = URL("api.magazin.ro/produse")
    println(u.host)
}
Corect
KOTLIN
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

Greșit
KOTLIN
import java.net.URL

fun main() {
    val u = URL("/api/comenzi")
    println(u)
}
Corect
KOTLIN
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ă tu

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.

Codul care dă eroarea
KOTLIN
import java.net.URL

fun main() {
    val adresaConfig = "api.magazin.ro/v1"
    val url = URL(adresaConfig)
    println("Server: ${url.host}, cale: ${url.path}")
}
După reparație, programul afișează
Server: api.magazin.ro, cale: /v1
Indiciu

Construiește textul "https://" + adresa înainte să creezi URL-ul.

Alte forme ale mesajului

  • Exception in thread "main" java.net.MalformedURLException: no protocol: example.com/api
  • java.net.MalformedURLException: no protocol:
  • java.net.MalformedURLException: unknown protocol: htps
  • java.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

← Toate erorile Kotlin

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