{"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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Răspunsul {"message":"Internal Server Error"} cu statusul 500 vine de la API Gateway, nu din codul tău. Înseamnă că integrarea cu Lambda a eșuat. Cauzele, în ordinea frecvenței:
- API Gateway nu are voie să invoce funcția: când legi un API de o funcție din CLI, trebuie să adaugi tu permisiunea cu
aws lambda add-permission --principal apigateway.amazonaws.com(consola o adaugă singură); - funcția a aruncat o excepție sau a depășit timeout-ul;
- funcția a întors un răspuns pe care API Gateway nu-l înțelege (de exemplu
bodyca obiect, nu ca text JSON, la formatul 1.0).
Dacă politica funcției (aws lambda get-policy) nu are o declarație pentru apigateway.amazonaws.com, funcția nici nu rulează și nu apare nimic în logurile ei. Dacă rulează, eroarea apare în aws logs tail /aws/lambda/<functie>.
De ce apare: cauzele frecvente
1Lipsește permisiunea pentru API Gateway
aws apigatewayv2 create-integration --api-id $API --integration-type AWS_PROXY \
--integration-uri arn:aws:lambda:eu-central-1:123456789012:function:api-salut \
--payload-format-version 2.0aws lambda add-permission --function-name api-salut --statement-id apigw \
--action lambda:InvokeFunction --principal apigateway.amazonaws.com \
--source-arn "arn:aws:execute-api:eu-central-1:123456789012:$API/*"Politica funcției trebuie să permită serviciului API Gateway (doar pentru acest API) să o invoce.
2Funcția aruncă o eroare
export const handler = async (event) => {
const date = JSON.parse(event.body); // body lipsește la GET
return { statusCode: 200, body: JSON.stringify(date) };
};export const handler = async (event) => {
const date = JSON.parse(event.body || "{}");
return { statusCode: 200, body: JSON.stringify(date) };
};La un GET, event.body lipsește, iar JSON.parse(undefined) aruncă eroare; API Gateway transformă eroarea în 500.
3Răspuns în format greșit
return { statusCode: 200, body: { salut: "Salut!" } };return { statusCode: 200, headers: { "Content-Type": "application/json" },
body: JSON.stringify({ salut: "Salut!" }) };body trebuie să fie text; obiectul se transformă cu JSON.stringify.
Repară eroarea, direct în pagină
API-ul HTTP magazin-api are ruta GET /salut, legată de funcția api-salut, dar orice cerere primește {"message":"Internal Server Error"}, iar funcția nu are loguri. Adaugă permisiunea care lasă API Gateway să invoce funcția (ID-ul declarației: apigw, limitată la acest API), apoi verifică cu curl pe /salut?nume=Ana.
Indiciu
aws lambda add-permission --function-name api-salut --statement-id apigw --action lambda:InvokeFunction --principal apigateway.amazonaws.com --source-arn "arn:aws:execute-api:eu-central-1:123456789012:$API/*".
Reparația
Dă-i lui API Gateway permisiunea să invoce funcția:
API=$(aws apigatewayv2 get-apis --query "Items[?Name=='magazin-api'].ApiId" --output text)
aws lambda add-permission --function-name api-salut --statement-id apigw --action lambda:InvokeFunction --principal apigateway.amazonaws.com --source-arn "arn:aws:execute-api:eu-central-1:123456789012:$API/*"
curl -s "https://$API.execute-api.eu-central-1.amazonaws.com/salut?nume=Ana"De ce merge
API-ul fusese legat de funcție din CLI, fără permisiune, deci Lambda refuza invocările venite de la API Gateway, care răspundea cu 500. Declarația apigw permite serviciului apigateway.amazonaws.com să invoce api-salut, doar pentru magazin-api (prin --source-arn). Acum funcția rulează și răspunde cu {"salut":"Salut, Ana!"}.
Alte forme ale mesajului
HTTP/1.1 500 Internal Server Error{"message": "Internal server error"}{"message":"Service Unavailable"}
Cum o eviți pe viitor
- În scriptul care leagă API-ul de funcție, pune
add-permissionimediat dupăcreate-integration. - Activează logurile funcției (
AWSLambdaBasicExecutionRole) și uită-te în ele la primul 500. - Testează funcția direct (
aws lambda invoke) cu un event de API Gateway, înainte să testezi prin API. - Întoarce mereu
statusCode,headersșibodyca text.
Întrebări frecvente
De ce nu văd nimic în logurile funcției?
Cel mai probabil funcția nici nu a fost apelată: API Gateway n-are permisiunea. Verifică aws lambda get-policy --function-name api-salut.
Ce e cu /* din --source-arn?
arn:aws:execute-api:regiune:cont:API/* permite apelul din orice stage, metodă și cale a acestui API. Poți restrânge, de exemplu $API/*/GET/salut.
Erori înrudite
"FunctionError": "Unhandled" Funcția a rulat, dar codul ei a aruncat o excepție pe care n-a prins-o. Detaliile (errorType, errorMessage, trace) sunt în fișierul de ieșire al lui aws lambda invoke și în logurile CloudWatch. Repară codul (de obicei citește un câmp care nu există în event) și urcă-l cu update-function-code. {"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. {"Message":"Forbidden. For troubleshooting Function URL authorization issues, see: https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html"} Function URL-ul funcției răspunde 403 Forbidden: fie are AuthType AWS_IAM și cererea nu e semnată, fie are AuthType NONE, dar politica funcției nu permite accesul public. Pentru un URL public, adaugă permisiunea lambda:InvokeFunctionUrl cu --principal "*" și --function-url-auth-type NONE. Î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.
