curl: (3) URL rejected: Malformed input to a URL function
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ă
curl -fsS -o cursuri.json "$API_URL/cursuri.json"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
curl http:/server/api/cursuri.jsoncurl http://server/api/cursuri.jsonForma corectă e protocol://server/cale.
3Spații sau caractere speciale în adresă
curl "http://server/api/cauta?q=curs linux"curl -G --data-urlencode "q=curs linux" http://server/api/cautaSpațiile trebuie codificate (%20); --data-urlencode face asta pentru parametri.
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.
Reparația
cat api.env
sed -i 's|^curl|source api.env\ncurl|' descarca.sh
cat descarca.sh
./descarca.sh
head -3 cursuri.jsonDe ce merge
API_URL era definită în api.env, dar scriptul nu citea fișierul, deci variabila era goală și curl primea doar /cursuri.json, o adresă fără protocol și fără server.
source api.env execută fișierul în shell-ul scriptului, așa că API_URL primește valoarea http://server/api. Adresa completă e validă, iar curl descarcă lista.
Alte forme ale mesajului
curl: (3) URL rejected: No host part in the URLcurl: (3) URL using bad/illegal format or missing URLcurl: (3) URL rejected: Port number was not a decimal number between 0 and 65535curl: (3) URL rejected: Bad hostnamecurl: (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.shca 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
curl: (6) Could not resolve host: api.acadmia.ro Numele din URL nu a putut fi tradus într-o adresă IP: de obicei e scris greșit, nu are încă înregistrare DNS sau serverul nu are DNS/internet. Verifică numele caracter cu caracter, apoi cu getent hosts sau dig dacă se rezolvă. curl: (22) The requested URL returned error: 404 Serverul a răspuns, dar cu un cod de eroare HTTP (aici 404, pagina nu există), iar opțiunea -f (--fail) l-a făcut pe curl să iasă cu codul 22. Verifică adresa (calea, numele fișierului, litere mari) cu curl -I sau în browser și corecteaz-o. salut.sh: line 3: $1: unbound variable Scriptul are set -u (sau set -euo pipefail) și folosește o variabilă care nu are nicio valoare, aici primul argument ($1), care lipsește. Dă argumentul sau folosește o valoare implicită: ${1:-lume}. Î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.
