Come posso risolvere l'errore 404 NoSuchKey di Amazon S3?

Risoluzione

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Amazon S3 può restituire errori 404 se l'oggetto richiesto non è presente nel bucket. Prima che gli utenti effettuino richieste GET o HEAD per un oggetto, verifica che l'oggetto sia disponibile nella directory S3 o nel bucket generico.

Nota: la soluzione descritta in questo articolo si applica solo ai bucket di directory Amazon S3 e ai bucket generici.

Per verificare se un oggetto è disponibile in un bucket, esaminane il contenuto dalla console Amazon S3. In alternativa, puoi utilizzare l'Interfaccia della linea di comando AWS (AWS CLI) per eseguire il comando head-object:

aws s3api head-object --bucket awsexamplebucket --key object.jpg

Nota: sostituisci awsexamplebucket con il nome del tuo bucket e object.jpg con il nome del tuo oggetto.

Tieni presente che Amazon S3 offre una coerenza assoluta di lettura dopo scrittura per tutte le applicazioni. Dopo la scrittura, la sovrascrittura o l'eliminazione di un oggetto, qualsiasi richiesta di lettura riceve immediatamente la versione più recente dell'oggetto. Amazon S3 offre coerenza assoluta anche per le operazioni di elenco. Dopo una scrittura, puoi elencare gli oggetti in un bucket. Per ulteriori informazioni sulla coerenza di Amazon S3, consulta Amazon S3 Strong Consistency (Coerenza assoluta di Amazon S3).

Se l'oggetto richiesto è disponibile nel bucket S3 e ricevi nuovamente un errore "404 NoSuchKey", controlla quanto segue:

• Verifica che la richiesta corrisponda esattamente al nome dell'oggetto. Le richieste di oggetti S3 fanno distinzione tra maiuscole e minuscole. Ad esempio, se un oggetto è denominato myimage.jpg, ma viene richiesto Myimage.jpg, il richiedente riceve un errore "404 NoSuchKey".

• Verifica che il percorso richiesto corrisponda al percorso dell'oggetto. Altrimenti, il richiedente riceve un errore "404 NoSuchKey".

• Se il percorso dell'oggetto contiene spazi, verifica che la richiesta utilizzi la sintassi corretta per riconoscere il percorso. Ad esempio, se utilizzi AWS CLI per scaricare un oggetto su un computer Windows, devi inserire le virgolette attorno al percorso dell'oggetto. Il percorso dell'oggetto deve essere simile all'esempio seguente:

  aws s3 cp "s3://awsexamplebucket/Backup Copy Job 4/3T000000.vbk"

  Nota: sostituisci il percorso dell'oggetto con il tuo percorso.

• Controlla il nome dell'oggetto per verificare la presenza di eventuali caratteri speciali o caratteri codificati in URL che sono difficili da vedere, ad esempio ritorni a capo (\r) o interruzioni di riga (\n). Per esempio, il nome di un oggetto test con ritorno a capo alla fine viene visualizzato come test%0A nella console Amazon S3. Per controllare se i nomi degli oggetti contengono caratteri speciali, puoi eseguire il comando list-objects-v2 con il parametro --output json. L'output JSON rende visibili caratteri come i ritorni a capo (\r). Se il nome di un oggetto presenta un carattere speciale che non è visibile, rimuovi il carattere dal nome. Prova ad accedere nuovamente all'oggetto.

• (Facoltativo) Puoi abilitare la registrazione degli accessi al server per esaminare i record delle richieste in modo più dettagliato con lo scopo di individuare eventuali problemi che potrebbero causare l'errore "404 NoSuchKey".

Nota: se nel bucket manca un oggetto e il richiedente non dispone dell'accesso a s3:ListBucket, il richiedente riceve un errore "403 Access Denied". Se ricevi un errore "403 Access Denied", risolvi il problema relativo all'oggetto mancante.

Informazioni correlate

Risoluzione dei problemi relativi agli errori di accesso negato (403 Forbidden) in Amazon S3