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

curl: (22) The requested URL returned error: 404

Pe scurt

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.

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

Ce înseamnă

Implicit, curl salvează orice răspuns, chiar și pagina de eroare, și iese cu 0. Cu -f (--fail), un cod HTTP de 400 sau mai mare devine eroare: curl nu salvează corpul răspunsului, afișează The requested URL returned error: 404 și iese cu codul 22. E comportamentul dorit în scripturi, ca un fișier lipsă să nu treacă neobservat.

Codul din mesaj îți spune problema: 404 = calea nu există pe server (greșeală de tastare, versiune veche a API-ului, / lipsă), 401/403 = lipsește autentificarea sau nu ai acces, 500/502/503 = serverul are o problemă. Pentru detalii rulează curl -i URL (arată și antetele răspunsului) sau curl -I URL (doar antetele). Diferența față de curl: (7) e importantă: acolo nu s-a putut face conexiunea deloc; aici serverul a răspuns.

De ce apare: cauzele frecvente

1Calea sau numele fișierului greșit

Greșit
BASH
curl -fsS -o cursuri.json http://server/api/curs.json
Corect
BASH
curl -fsS -o cursuri.json http://server/api/cursuri.json

Serverul are fișierul cursuri.json, nu curs.json. Pe Linux contează și literele mari.

2Lipsește autentificarea

Greșit
BASH
curl -f https://api.exemplu.ro/v1/comenzi
Corect
BASH
curl -f -H "Authorization: Bearer $TOKEN" https://api.exemplu.ro/v1/comenzi

Un 401 sau 403 înseamnă că serverul cere un token sau o cheie.

3Eroarea ascunsă fără -f

Greșit
BASH
curl -s -o date.csv http://server/date-vechi.csv
Corect
BASH
curl -fsS -o date.csv http://server/date.csv

Fără -f, date.csv ar conține pagina HTML de eroare și scriptul ar continua cu date greșite.

Repară tu

Repară eroarea, direct în pagină

Scriptul descarca.sh trebuie să descarce lista cursurilor de la http://server/api/ în cursuri.json. Rulat, dă curl: (22) The requested URL returned error: 404. Află adresa corectă din documentația API-ului (fișierul api.txt din folderul curent), repară scriptul și rulează-l, ca cursuri.json să conțină lista.

Indiciu

Compară adresa din script cu cea din api.txt.

Alte forme ale mesajului

  • curl: (22) The requested URL returned error: 403
  • curl: (22) The requested URL returned error: 500
  • curl: (22) The requested URL returned error: 404 Not Found
  • ERROR 404: Not Found.
  • HTTP/1.1 404 Not Found

Cum o eviți pe viitor

  • În scripturi folosește curl -fsS (-f eșuează la erori HTTP, -s fără bară de progres, -S arată totuși erorile).
  • Verifică adresa cu curl -I URL înainte s-o pui în script.
  • Pentru API-uri, afișează codul cu curl -s -o /dev/null -w '%{http_code}\n' URL.
  • Testează în script codul de ieșire: curl -fsS ... || { echo 'descarcare esuata'; exit 1; }.

Întrebări frecvente

De ce fără -f curl spune că totul e în regulă?

Pentru că din punctul lui de vedere a primit un răspuns complet. Codul HTTP 404 e doar conținutul răspunsului. -f îi spune să trateze codurile de eroare ca eșec.

Care e diferența față de curl: (7)?

La 7 nu s-a putut face conexiunea (serverul nu ascultă, portul e închis). La 22 conexiunea a mers și serverul a răspuns cu o eroare HTTP.

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.