...
Eroare AWS · S3: bucket-uri, obiecte și acces public

An error occurred (404) when calling the HeadObject operation: Not Found

Pe scurt

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

Greșit
BASH
aws s3api head-object --bucket rapoarte-firma-2026 --key octombrie.csv
Corect
BASH
aws 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

Greșit
BASH
aws s3 cp s3://rapoarte-firma-2026/rapoarte/Octombrie.CSV .
Corect
BASH
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

Greșit
BASH
{"Effect": "Allow", "Action": "s3:GetObject",
 "Resource": "arn:aws:s3:::rapoarte-firma-2026/*"}
Corect
BASH
{"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ă tu

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

Alte forme ale mesajului

  • fatal error: An error occurred (404) when calling the HeadObject operation: Key "octombrie.csv" does not exist
  • An error occurred (403) when calling the HeadObject operation: Forbidden
  • botocore.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 --recursive sau list-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

← Toate erorile AWS

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ță 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.