java.lang.IllegalArgumentException: URI is not absolute
Ai transformat în URL o adresă relativă, fără schemă și host ("/api/produse"). toURL() cere o adresă completă, ca https://magazin.ro/api/produse. Construiește adresa pornind de la URL-ul de bază: URI(baza).resolve("/api/produse").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un URI poate fi absolut (https://magazin.ro/api/produse, cu schemă și host) sau relativ (/api/produse, produse?pagina=2). Un URL, folosit ca să deschizi o conexiune, trebuie să fie absolut, pentru că altfel nu știe la ce server să se conecteze. URI.toURL() verifică asta și aruncă IllegalArgumentException: URI is not absolute.
Apare când:
- construiești cereri HTTP doar din cale, uitând URL-ul de bază din configurare;
- variabila cu adresa de bază e goală (de exemplu o variabilă de mediu lipsă) și rămâne doar calea;
- preiei din HTML un
hrefrelativ și îl folosești direct.
Reparația: URI(baza).resolve(cale) combină corect baza cu o cale relativă. Pentru o adresă fără protocol (example.com/api) primești altă eroare: MalformedURLException: no protocol.
De ce apare: cauzele frecvente
1Doar calea, fără bază
val url = URI("/api/produse").toURL()val url = URI("https://magazin.ro").resolve("/api/produse").toURL()resolve adaugă calea la adresa de bază și produce un URI absolut.
2Bază lipsă din configurare
val baza = System.getenv("API_URL") ?: ""
val url = URI(baza + "/produse").toURL()val baza = requireNotNull(System.getenv("API_URL")) { "Lipseste API_URL" }
val url = URI(baza + "/produse").toURL()Mai bine o eroare clară despre configurare decât un URL incomplet.
3Link relativ din HTML
val link = URI("poza.jpg").toURL()val link = URI("https://site.ro/galerie/").resolve("poza.jpg").toURL()Linkurile relative se rezolvă față de adresa paginii din care provin.
Repară eroarea, direct în pagină
Programul construiește URL-ul unei cereri doar din cale (/api/produse?pagina=2) și se oprește cu URI is not absolute. Combină calea cu adresa de bază https://magazin.ro folosind resolve, ca programul să afișeze Cerere catre magazin.ro/api/produse.
import java.net.URI
fun main() {
val url = URI("/api/produse?pagina=2").toURL()
println("Cerere catre ${url.host}${url.path}")
}Cerere catre magazin.ro/api/produse
Indiciu
Pornește de la URI("https://magazin.ro") și apelează resolve(cale) înainte de toURL().
Reparația
import java.net.URI
fun main() {
val baza = URI("https://magazin.ro")
val url = baza.resolve("/api/produse?pagina=2").toURL()
println("Cerere catre ${url.host}${url.path}")
}De ce merge
/api/produse?pagina=2 e un URI relativ: nu are schemă (https) și nici host, deci nu se poate transforma într-un URL la care să te conectezi. URI("https://magazin.ro").resolve(...) combină baza cu calea și produce https://magazin.ro/api/produse?pagina=2. Din URL-ul rezultat, host este magazin.ro, iar path este /api/produse (fără parametrii din query).
Alte forme ale mesajului
Exception in thread "main" java.lang.IllegalArgumentException: URI is not absolutejava.lang.IllegalArgumentException: URI is not absolute: /api/produse
Cum o eviți pe viitor
Ține URL-ul de bază al API-ului într-o singură constantă sau configurare și construiește toate adresele din ea cu resolve. Validează configurarea la pornire (require(baza.startsWith("https://"))). La HTTP, bibliotecile ca Ktor sau OkHttp au un baseUrl: setează-l o dată, apoi folosește doar căi.
Întrebări frecvente
De ce URI("/api") nu dă eroare, ci doar toURL()?
Pentru că un URI relativ e perfect valid ca identificator. Doar transformarea în URL, care trebuie să știe serverul, cere o adresă absolută.
Ce face resolve cu o cale care începe cu /?
O pune direct după host, înlocuind calea bazei: https://site.ro/v1/ + /api → https://site.ro/api. Fără / la început, calea se adaugă la directorul bazei: https://site.ro/v1/ + api → https://site.ro/v1/api.
Erori înrudite
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. 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.lang.NullPointerException: getenv(...) must not be null O funcție Java a întors null, iar tu ai pus rezultatul într-o variabilă Kotlin non-null (String). Kotlin verifică la atribuire și aruncă excepția. Declară variabila nullable (String?) și tratează null-ul, de obicei cu ?: și o valoare implicită. Î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.
