{"message":"Not Found"}
Nicio rută a API-ului nu se potrivește cu metoda și calea cererii. Verifică cu aws apigatewayv2 get-routes cheile exacte (de exemplu "GET /salut"): calea e sensibilă la majuscule, iar metoda trebuie să fie aceeași. Corectează ruta sau adresa cererii.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un API HTTP din API Gateway caută pentru fiecare cerere o rută cu exact aceeași metodă și cale (GET /salut). Dacă nu găsește nicio rută și nu există ruta $default, răspunde cu statusul 404 și {"message":"Not Found"}, fără să apeleze vreo funcție.
Cauzele obișnuite:
- calea diferă prin majuscule (
/Salutfață de/salut), o literă sau un/la final; - metoda diferă (ruta e
GET, cererea ePOST); - adresa conține numele unui stage care nu există (
/prod/salut, când API-ul are doar$default) sau lipsește numele stage-ului; - ai creat ruta, dar stage-ul nu are
--auto-deploy, deci modificarea nu a fost publicată.
Vezi rutele cu aws apigatewayv2 get-routes --api-id $API --query 'Items[].RouteKey' și stage-urile cu get-stages.
De ce apare: cauzele frecvente
1Majuscule diferite în cale
aws apigatewayv2 create-route --api-id $API --route-key "GET /Salut" ...
curl https://$API.execute-api.eu-central-1.amazonaws.com/salutaws apigatewayv2 update-route --api-id $API --route-id $RUTA --route-key "GET /salut"Căile sunt sensibile la majuscule; ruta trebuie să fie exact /salut.
2Metoda nu se potrivește
aws apigatewayv2 create-route --api-id $API --route-key "GET /rezervari" ...
curl -X POST https://$API.execute-api.eu-central-1.amazonaws.com/rezervariaws apigatewayv2 create-route --api-id $API --route-key "POST /rezervari" \
--target integrations/$INTFiecare metodă are ruta ei (sau folosești ANY /rezervari).
3Stage în adresă
curl https://$API.execute-api.eu-central-1.amazonaws.com/prod/salut
# API-ul are doar stage-ul $defaultcurl https://$API.execute-api.eu-central-1.amazonaws.com/salutStage-ul $default nu apare în adresă; un stage cu nume (prod) apare.
Repară eroarea, direct în pagină
Site-ul apelează GET /salut?nume=Ana pe API-ul magazin-api, dar primește {"message":"Not Found"}. Ruta a fost creată ca GET /Salut. Repară ruta (fără să creezi alta) ca cererile spre /salut să ajungă la funcția api-salut, apoi verifică cu curl.
Indiciu
Găsește RouteId-ul cu aws apigatewayv2 get-routes și schimbă cheia cu aws apigatewayv2 update-route --route-key "GET /salut".
Reparația
Vezi rutele și corectează cheia:
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
aws apigatewayv2 get-routes --api-id $API --query 'Items[].[RouteId,RouteKey]'
RUTA=$(aws apigatewayv2 get-routes --api-id $API --query "Items[?RouteKey=='GET /Salut'].RouteId" --output text)
aws apigatewayv2 update-route --api-id $API --route-id $RUTA --route-key "GET /salut"
curl -s "https://$API.execute-api.eu-central-1.amazonaws.com/salut?nume=Ana"De ce merge
API Gateway compară calea exact, inclusiv majusculele, deci cererea spre /salut nu se potrivea cu ruta /Salut și primea 404 fără să apeleze funcția. După update-route --route-key "GET /salut", ruta se potrivește, iar stage-ul $default cu auto-deploy publică imediat schimbarea: funcția răspunde cu Salut, Ana!.
Alte forme ale mesajului
HTTP/1.1 404 Not Found{"message":"Missing Authentication Token"}
Cum o eviți pe viitor
- Scrie căile cu litere mici și fără
/la final, peste tot (rute, frontend, documentație). - După modificări, listează rutele:
aws apigatewayv2 get-routes --api-id $API --query 'Items[].RouteKey'. - Folosește un stage cu
--auto-deploysau publică manual după fiecare schimbare.
Întrebări frecvente
Ce e „Missing Authentication Token”?
Este echivalentul lui Not Found la API-urile REST din API Gateway (nu HTTP API): calea sau metoda nu există. Mesajul derutează, dar rareori are legătură cu autentificarea.
Cum prind toate căile într-o singură funcție?
Cu ruta $default sau ANY /{proxy+}. Funcția primește calea în event.rawPath și decide singură ce să răspundă.
Erori înrudite
{"message":"Internal Server Error"} API Gateway n-a putut obține un răspuns valid de la funcția Lambda: de obicei îi lipsește permisiunea să apeleze funcția, funcția a aruncat o eroare sau a întors un răspuns în format greșit. Verifică întâi permisiunea (aws lambda get-policy), apoi logurile funcției. An error occurred (NotFoundException) when calling the CreateStage operation: Invalid API identifier specified 123456789012:magazin-api La --api-id ai dat altceva decât ID-ul API-ului, de obicei numele lui (magazin-api) sau un ID din altă regiune. ID-ul are 10 caractere, de exemplu a1b2c3d4e5. Îl afli cu aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text. 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. Î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.
