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

Task timed out after 3.00 seconds

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare funcție Lambda are un timeout: cât are voie să ruleze o invocare, între 1 secundă și 15 minute. Valoarea implicită este 3 secunde, prea puțin pentru multe sarcini reale. Când timpul expiră, Lambda oprește execuția, scrie în CloudWatch Logs Task timed out after 3.00 seconds și întoarce eroarea Sandbox.Timedout (FunctionError: Unhandled la aws lambda invoke).

Întrebarea importantă e de ce a durat atât. Uneori munca e pur și simplu lungă (procesarea unui fișier, un raport) și timeout-ul trebuie mărit. Alteori codul e blocat: o cerere HTTP spre un serviciu care nu răspunde, o funcție dintr-un VPC fără NAT care încearcă să iasă pe internet, o conexiune la bază de date care nu se închide, sau un await pe o promisiune care nu se rezolvă niciodată.

Uită-te în log la linia REPORT: Duration și Max Memory Used. O funcție care stă exact cât timeout-ul la fiecare invocare e aproape sigur blocată. Mai multă memorie aduce și mai mult CPU, deci poate scurta munca intensă.

De ce apare: cauzele frecvente

1Timeout-ul implicit de 3 secunde e prea mic

Greșit
BASH
aws lambda create-function --function-name raport --runtime nodejs22.x ...
# Timeout implicit: 3
Corect
BASH
aws lambda update-function-configuration --function-name raport --timeout 10
aws lambda wait function-updated --function-name raport

O sarcină care durează 5 secunde are nevoie de un timeout mai mare, cu o marjă.

2Apel de rețea fără timeout propriu

Greșit
BASH
export const handler = async () => {
  const r = await fetch("https://api.lent.example");
  return r.json();
};
Corect
BASH
export const handler = async () => {
  const r = await fetch("https://api.lent.example", { signal: AbortSignal.timeout(2000) });
  return r.json();
};

Un timeout pe cerere te lasă să tratezi eroarea înainte ca Lambda să oprească tot.

3Funcție în VPC fără ieșire la internet

Greșit
BASH
aws lambda update-function-configuration --function-name raport \
  --vpc-config SubnetIds=subnet-privat,SecurityGroupIds=sg-lambda
# subrețeaua nu are NAT gateway
Corect
BASH
# adaugă un NAT gateway în tabela de rutare a subrețelei private
# sau un VPC endpoint pentru serviciul AWS apelat

Fără NAT sau endpoint, cererile spre internet și spre API-urile AWS așteaptă până la timeout.

Repară tu

Repară eroarea, direct în pagină

Funcția Lambda raport-zilnic are nevoie de aproximativ 5 secunde ca să genereze raportul, dar fiecare invocare se termină cu Task timed out after 3.00 seconds. Mărește timeout-ul funcției la 10 secunde (fără să schimbi codul), apoi invoc-o și salvează răspunsul în ~/raport.json.

Indiciu

aws lambda update-function-configuration --function-name raport-zilnic --timeout 10, apoi aws lambda wait function-updated.

Alte forme ale mesajului

  • {"errorType":"Sandbox.Timedout","errorMessage":"RequestId: 11bb6d3f-1377-460a-8216-e852f8230888 Error: Task timed out after 3.00 seconds"}
  • Task timed out after 15.02 seconds
  • Status: timeout

Cum o eviți pe viitor

  • Alege timeout-ul după durata reală măsurată (din REPORT Duration) plus o marjă, nu valoarea maximă.
  • Pune timeout-uri pe toate apelurile de rețea din cod, mai mici decât timeout-ul funcției.
  • Pentru funcții în VPC, asigură ieșirea (NAT gateway sau VPC endpoints).
  • Pune o alarmă CloudWatch pe metrica Errors sau Duration a funcției.
  • Pentru munci de peste 15 minute, folosește alt serviciu (Step Functions, ECS).

Întrebări frecvente

Dacă pun timeout-ul la 15 minute, rezolv problema?

Doar dacă munca e legitim lungă. Dacă funcția e blocată, va sta blocată 15 minute și vei plăti pentru tot timpul. Află întâi cauza din loguri.

API Gateway întoarce 503 sau 504, iar funcția mea are timeout de 60 de secunde. De ce?

API Gateway are propriul timeout pentru integrare (implicit 29–30 de secunde). Dacă funcția durează mai mult, clientul primește eroare chiar dacă funcția termină mai târziu.

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.