...
Eroare AWS · API Gateway și SNS

{"message":"Internal Server Error"}

Pe scurt

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 body ca 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

Greșit
BASH
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.0
Corect
BASH
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/*"

Politica funcției trebuie să permită serviciului API Gateway (doar pentru acest API) să o invoce.

2Funcția aruncă o eroare

Greșit
BASH
export const handler = async (event) => {
  const date = JSON.parse(event.body);  // body lipsește la GET
  return { statusCode: 200, body: JSON.stringify(date) };
};
Corect
BASH
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

Greșit
BASH
return { statusCode: 200, body: { salut: "Salut!" } };
Corect
BASH
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ă tu

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

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-permission imediat 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 și body ca 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

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