"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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
aws lambda invoke se termină cu StatusCode: 200 chiar și când funcția a eșuat: 200 înseamnă doar că Lambda a primit cererea și a rulat funcția. Dacă în răspuns apare și "FunctionError": "Unhandled", codul a aruncat o excepție neprinsă, iar fișierul de ieșire (raspuns.json) conține eroarea în loc de rezultat:
{"errorType":"TypeError","errorMessage":"Cannot read properties of undefined (reading 'nume')","trace":[...]}Citește întâi errorType și errorMessage, apoi trace, care arată fișierul și linia. Cea mai des întâlnită cauză este diferența dintre forma presupusă a lui event și cea primită: payload-ul este {"nume":"Ana"}, dar codul citește event.client.nume. La fel, un API Gateway trimite corpul ca text în event.body, care trebuie întâi parsat cu JSON.parse. Logurile complete sunt în aws logs tail /aws/lambda/salut.
De ce apare: cauzele frecvente
1Codul citește un câmp care nu există în event
export const handler = async (event) => {
return { mesaj: "Salut, " + event.client.nume + "!" };
};
// payload: {"nume":"Ana"}export const handler = async (event) => {
return { mesaj: "Salut, " + event.nume + "!" };
};event.client este undefined, iar citirea unui câmp din undefined aruncă TypeError.
2Corpul de la API Gateway nu e parsat
export const handler = async (event) => {
return { total: event.body.cantitate * 10 };
};export const handler = async (event) => {
const date = JSON.parse(event.body || "{}");
return { statusCode: 200, body: JSON.stringify({ total: date.cantitate * 10 }) };
};API Gateway trimite corpul cererii ca text JSON în event.body.
3Variabilă nedefinită
export const handler = async (event) => ({ mesaj: "Salut, " + nume });export const handler = async (event) => ({ mesaj: "Salut, " + event.nume });nume nu există în cod, deci apare ReferenceError: nume is not defined.
Repară eroarea, direct în pagină
Funcția salut trebuie să răspundă cu Salut, <nume>! pentru payload-ul {"nume":"Ana"}. Scriptul ~/invoca.sh o apelează, dar primește "FunctionError": "Unhandled", iar în ~/raspuns.json apare un TypeError. Repară codul din ~/salut/index.mjs, urcă-l în funcție și rulează din nou ~/invoca.sh.
Indiciu
Payload-ul are câmpul nume direct pe event: event.nume, nu event.client.nume. Urcă codul cu update-function-code și așteaptă cu wait function-updated.
Reparația
Citește câmpul corect din event și urcă codul:
cat > ~/salut/index.mjs <<'EOF'
export const handler = async (event) => ({ mesaj: "Salut, " + event.nume + "!" });
EOF
cd ~/salut && rm -f ../salut.zip && zip -q ../salut.zip index.mjs && cd ~
aws lambda update-function-code --function-name salut --zip-file fileb://salut.zip
aws lambda wait function-updated --function-name salut
bash ~/invoca.shDe ce merge
Codul citea event.client.nume, dar payload-ul nu are câmpul client, deci event.client era undefined, iar citirea lui nume a aruncat TypeError. Cu event.nume, funcția găsește valoarea trimisă. După update-function-code și wait function-updated, invocarea întoarce {"mesaj": "Salut, Ana!"}, fără FunctionError.
Alte forme ale mesajului
{"errorType":"TypeError","errorMessage":"Cannot read properties of undefined (reading 'nume')","trace":["TypeError: Cannot read properties of undefined (reading 'nume')"," at Runtime.handler (file:///var/task/index.mjs)"]}{"errorType":"ReferenceError","errorMessage":"nume is not defined"}
Cum o eviți pe viitor
- Testează funcția cu un payload exact ca cel real (salvează exemple de event în fișiere).
- Citește câmpurile cu valori implicite:
event?.nume ?? "vizitator". - În scripturi, verifică
FunctionErrordin răspunsul luiinvoke, nu doarStatusCode. - Dă rolului funcției
AWSLambdaBasicExecutionRole, ca erorile să apară în CloudWatch Logs.
Întrebări frecvente
De ce StatusCode e 200 dacă funcția a eșuat?
StatusCode descrie invocarea (Lambda a rulat funcția), nu rezultatul codului. Eroarea codului e semnalată separat, prin FunctionError și conținutul fișierului de ieșire.
Ce înseamnă Unhandled față de Handled?
Unhandled = excepția a ieșit din handler. Când prinzi eroarea și întorci tu un răspuns (de exemplu statusCode: 400), Lambda consideră invocarea reușită și nu mai apare FunctionError.
Erori înrudite
Runtime.HandlerNotFound: index.handler is undefined or not exported Lambda a încărcat fișierul index.mjs, dar acesta nu exportă o funcție numită handler. Adaugă export (export const handler = ...) sau schimbă setarea Handler ca să numească funcția exportată, apoi publică din nou codul. Task timed out after 3.00 seconds Funcția Lambda a rulat mai mult decât timeout-ul ei (implicit 3 secunde), iar Lambda a oprit-o. Mărește timeout-ul (aws lambda update-function-configuration --timeout 10) dacă munca e legitim lungă, sau află de ce codul așteaptă: un apel de rețea blocat, o buclă, o promisiune care nu se rezolvă. Runtime.UserCodeSyntaxError: SyntaxError: Unexpected token ';' Codul funcției Lambda are o greșeală de sintaxă, așa că runtime-ul nu îl poate încărca: invocarea întoarce FunctionError: Unhandled, iar în răspuns apare Runtime.UserCodeSyntaxError. Rulează codul local (node --check index.mjs), repară sintaxa, apoi publică din nou cu update-function-code. Î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.
