...
Eroare Linux · Rețea, SSH și pachete apt

curl: (3) URL rejected: Malformed input to a URL function

Pe scurt

curl nu a putut interpreta adresa primită, deci nici n-a încercat conexiunea. De obicei adresa e incompletă: o variabilă goală ("$API_URL/cursuri.json" devine "/cursuri.json"), lipsește // după http:, un spațiu sau un port greșit. Afișează adresa cu echo și repar-o.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Codul 3 de la curl înseamnă URL malformed: textul primit nu e o adresă validă. Versiunile noi de curl adaugă motivul: Malformed input to a URL function, No host part in the URL, Port number was not a decimal number between 0 and 65535, iar cele vechi spun URL using bad/illegal format or missing URL. Spre deosebire de codurile 6 (nume negăsit) sau 7 (conexiune refuzată), aici nu s-a trimis nimic în rețea.

În scripturi, cauza clasică e o variabilă goală: adresa se construiește din $API_URL, care nu a fost încărcată (fișierul .env nu e citit cu source, variabila nu e exportată sau are alt nume). Rulează scriptul cu bash -x ca să vezi exact adresa trimisă lui curl.

De ce apare: cauzele frecvente

1Variabila cu adresa nu e încărcată

Greșit
BASH
curl -fsS -o cursuri.json "$API_URL/cursuri.json"
Corect
BASH
source api.env
curl -fsS -o cursuri.json "${API_URL:?}/cursuri.json"

Fără source, $API_URL e gol și adresa devine /cursuri.json, fără protocol și fără server.

2Lipsesc // după protocol

Greșit
BASH
curl http:/server/api/cursuri.json
Corect
BASH
curl http://server/api/cursuri.json

Forma corectă e protocol://server/cale.

3Spații sau caractere speciale în adresă

Greșit
BASH
curl "http://server/api/cauta?q=curs linux"
Corect
BASH
curl -G --data-urlencode "q=curs linux" http://server/api/cauta

Spațiile trebuie codificate (%20); --data-urlencode face asta pentru parametri.

Repară tu

Repară eroarea, direct în pagină

Scriptul descarca.sh descarcă lista cursurilor de la adresa din API_URL, definită în fișierul api.env. Rulat, dă curl: (3) URL rejected: Malformed input to a URL function. Repară scriptul ca să încarce configurarea și rulează-l, ca cursuri.json să conțină lista.

Indiciu

Variabila e definită în api.env, dar scriptul nu citește niciodată acel fișier.

Alte forme ale mesajului

  • curl: (3) URL rejected: No host part in the URL
  • curl: (3) URL using bad/illegal format or missing URL
  • curl: (3) URL rejected: Port number was not a decimal number between 0 and 65535
  • curl: (3) URL rejected: Bad hostname
  • curl: (3) nested brace in URL position 30

Cum o eviți pe viitor

  • Construiește adresa într-o variabilă și afișeaz-o (echo "$url") înainte de curl, când depanezi.
  • Folosește ${API_URL:?} ca scriptul să se oprească clar dacă variabila lipsește.
  • Pune adresele între ghilimele, mai ales dacă au ?, &, [ sau {.
  • Rulează bash -x script.sh ca să vezi comanda curl exact cum e executată.

Întrebări frecvente

De ce curl -s nu afișează nimic?

-s ascunde și mesajele de eroare. Folosește -sS: fără bară de progres, dar cu erori. Codul de ieșire, 3, se vede cu echo $?.

Ce e eroarea „nested brace”?

curl tratează {} și [] din adresă ca tipare pentru mai multe adrese. Pune adresa între ghilimele și adaugă -g (--globoff) dacă acoladele fac parte din adresă.

Erori înrudite

← Toate erorile Linux

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ță Linux de la zero, cu exerciții la fiecare lecție

Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.