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

java.lang.IllegalArgumentException: URI is not absolute

Pe scurt

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 href relativ ș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ă

Greșit
KOTLIN
val url = URI("/api/produse").toURL()
Corect
KOTLIN
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

Greșit
KOTLIN
val baza = System.getenv("API_URL") ?: ""
val url = URI(baza + "/produse").toURL()
Corect
KOTLIN
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

Greșit
KOTLIN
val link = URI("poza.jpg").toURL()
Corect
KOTLIN
val link = URI("https://site.ro/galerie/").resolve("poza.jpg").toURL()

Linkurile relative se rezolvă față de adresa paginii din care provin.

Repară tu

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.

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

fun main() {
    val url = URI("/api/produse?pagina=2").toURL()
    println("Cerere catre ${url.host}${url.path}")
}
După reparație, programul afișează
Cerere catre magazin.ro/api/produse
Indiciu

Pornește de la URI("https://magazin.ro") și apelează resolve(cale) înainte de toURL().

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IllegalArgumentException: URI is not absolute
  • java.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

← 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.