An error occurred (404) when calling the HeadObject operation: Not Found
Obiectul cerut nu există la cheia dată: numele, folderul (prefixul) sau majusculele diferă. Verifică cheia exactă cu aws s3 ls s3://bucket/ --recursive și folosește-o identic.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HeadObject cere doar metadatele unui obiect (mărime, tip, data), fără conținut. Răspunsurile HEAD nu au corp, deci S3 nu poate trimite un mesaj ca NoSuchKey: trimite doar codul HTTP, iar CLI-ul afișează (404) ... Not Found.
O vezi la aws s3api head-object, la aws s3 cp când descarci un fișier care nu există (fatal error: ... HeadObject ... Key "..." does not exist) și în SDK-uri când verifici dacă un fișier există.
Cauze frecvente: lipsește prefixul (octombrie.csv în loc de rapoarte/octombrie.csv), majuscule diferite (cheile S3 țin cont de ele), o extensie greșită, un spațiu sau / în plus ori obiectul a fost șters. Dacă primești 403 în loc de 404 pentru un obiect lipsă, înseamnă că nu ai s3:ListBucket pe bucket: fără drept de listare, S3 nu-ți spune dacă obiectul există.
De ce apare: cauzele frecvente
1Lipsește prefixul din cheie
aws s3api head-object --bucket rapoarte-firma-2026 --key octombrie.csvaws s3 ls s3://rapoarte-firma-2026/ --recursive
aws s3api head-object --bucket rapoarte-firma-2026 --key rapoarte/octombrie.csv„Folderele” din S3 sunt parte din cheie. Cheia completă include prefixul.
2Majuscule sau extensie diferite
aws s3 cp s3://rapoarte-firma-2026/rapoarte/Octombrie.CSV .aws s3 cp s3://rapoarte-firma-2026/rapoarte/octombrie.csv .Octombrie.CSV și octombrie.csv sunt chei diferite.
3Primești 403 în loc de 404
{"Effect": "Allow", "Action": "s3:GetObject",
"Resource": "arn:aws:s3:::rapoarte-firma-2026/*"}{"Effect": "Allow", "Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::rapoarte-firma-2026"},
{"Effect": "Allow", "Action": "s3:GetObject",
"Resource": "arn:aws:s3:::rapoarte-firma-2026/*"}Cu s3:ListBucket, un obiect lipsă dă 404 (clar), nu 403 (ambiguu).
Repară eroarea, direct în pagină
Scriptul ~/descarca.sh trebuie să verifice raportul din octombrie din bucket-ul rapoarte-firma-2026 și să-l descarce în ~/octombrie.csv, dar dă (404) when calling the HeadObject operation: Not Found. Găsește cheia corectă, repară scriptul și rulează-l.
Indiciu
aws s3 ls s3://rapoarte-firma-2026/ --recursive îți arată cheia completă: raportul e sub prefixul rapoarte/.
Reparația
Folosește cheia completă, cu prefixul:
aws s3 ls s3://rapoarte-firma-2026/ --recursive
cat > ~/descarca.sh <<'EOF'
set -e
KEY=rapoarte/octombrie.csv
aws s3api head-object --bucket rapoarte-firma-2026 --key $KEY --query ContentLength
aws s3 cp s3://rapoarte-firma-2026/$KEY ~/octombrie.csv
EOF
bash ~/descarca.shDe ce merge
Cheia octombrie.csv nu există: raportul a fost încărcat la rapoarte/octombrie.csv. „Folderele” din S3 sunt parte din numele cheii, deci prefixul trebuie scris de fiecare dată. Cu cheia completă, HeadObject găsește obiectul și descărcarea merge. Cheile corecte le iei din listare, nu din memorie, așa că greșelile de prefix sau de majuscule dispar.
Alte forme ale mesajului
fatal error: An error occurred (404) when calling the HeadObject operation: Key "octombrie.csv" does not existAn error occurred (403) when calling the HeadObject operation: Forbiddenbotocore.exceptions.ClientError: An error occurred (404) when calling the HeadObject operation: Not Found
Cum o eviți pe viitor
- Ia cheile din listare (
aws s3 ls --recursivesaulist-objects-v2 --query 'Contents[].Key'), nu le scrie de mână. - Folosește o convenție de nume: litere mici, fără spații, cu prefixe clare (
rapoarte/2026-10.csv). - În cod, tratează 404 la HeadObject ca „fișierul nu există” și 403 ca „nu am drepturi sau nu pot lista”.
Întrebări frecvente
De ce mesajul e doar Not Found, fără detalii?
Răspunsurile la cererile HEAD nu au corp, deci S3 trimite doar codul 404. La GetObject, același caz dă mesajul complet NoSuchKey: The specified key does not exist.
Cum verific dintr-un script dacă un fișier există în S3?
aws s3api head-object --bucket b --key k > /dev/null 2>&1 && echo exista || echo lipseste. Codul de ieșire e 0 doar când obiectul există.
Erori înrudite
An error occurred (NoSuchKey) when calling the GetObject operation: The specified key does not exist. Bucket-ul există, dar nu are niciun obiect cu exact cheia (calea) cerută. Listează cu aws s3 ls s3://bucket/ --recursive și copiază cheia completă, cu prefixul („folderul”) și literele mari sau mici exacte. An error occurred (AccessDenied) when calling the ListObjectsV2 operation: User: arn:aws:iam::123456789012:user/contabil is not authorized to perform: s3:ListBucket on resource: "arn:aws:s3:::facturi-firma-2026" because no identity-based policy allows the s3:ListBucket action Cheile sunt bune, dar identitatea ta nu are nicio politică IAM care să permită acțiunea cerută (aici s3:ListBucket pe bucket). Atașează utilizatorului o politică cu acțiunea și resursa din mesaj, de exemplu s3:ListBucket pe arn:aws:s3:::facturi-firma-2026 și s3:GetObject pe arn:aws:s3:::facturi-firma-2026/*. An error occurred (NoSuchBucket) when calling the ListObjectsV2 operation: The specified bucket does not exist S3 nu găsește bucket-ul cu numele din comandă: e scris greșit (numele sunt exacte, cu litere mici), a fost șters sau încă nu l-ai creat. Verifică numele cu aws s3 ls și corectează comanda, ori creează bucket-ul cu aws s3 mb. Învață AWS de la zero, cu exerciții la fiecare lecție
Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
