...
Eroare AWS · Lambda: timeout, handler și roluri

"FunctionError": "Unhandled"

Pe scurt

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:

JSON
{"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

Greșit
BASH
export const handler = async (event) => {
  return { mesaj: "Salut, " + event.client.nume + "!" };
};
// payload: {"nume":"Ana"}
Corect
BASH
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

Greșit
BASH
export const handler = async (event) => {
  return { total: event.body.cantitate * 10 };
};
Corect
BASH
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ă

Greșit
BASH
export const handler = async (event) => ({ mesaj: "Salut, " + nume });
Corect
BASH
export const handler = async (event) => ({ mesaj: "Salut, " + event.nume });

nume nu există în cod, deci apare ReferenceError: nume is not defined.

Repară tu

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.

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ă FunctionError din răspunsul lui invoke, nu doar StatusCode.
  • 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

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