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ă.
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
aws lambda create-function --function-name raport --runtime nodejs22.x ...
# Timeout implicit: 3aws lambda update-function-configuration --function-name raport --timeout 10
aws lambda wait function-updated --function-name raportO sarcină care durează 5 secunde are nevoie de un timeout mai mare, cu o marjă.
2Apel de rețea fără timeout propriu
export const handler = async () => {
const r = await fetch("https://api.lent.example");
return r.json();
};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
aws lambda update-function-configuration --function-name raport \
--vpc-config SubnetIds=subnet-privat,SecurityGroupIds=sg-lambda
# subrețeaua nu are NAT gateway# adaugă un NAT gateway în tabela de rutare a subrețelei private
# sau un VPC endpoint pentru serviciul AWS apelatFără NAT sau endpoint, cererile spre internet și spre API-urile AWS așteaptă până la timeout.
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.
Reparația
Vezi timeout-ul actual și mărește-l:
aws lambda get-function-configuration --function-name raport-zilnic --query Timeout
aws lambda update-function-configuration --function-name raport-zilnic --timeout 10
aws lambda wait function-updated --function-name raport-zilnicInvocă funcția:
aws lambda invoke --function-name raport-zilnic ~/raport.json
cat ~/raport.jsonDe ce merge
Funcția fusese creată cu timeout-ul implicit, 3 secunde, iar codul așteaptă intenționat 5 secunde, așa că Lambda o oprea înainte de final. Cu --timeout 10, invocarea are destul timp și întoarce {"generat": true}. wait function-updated contează: imediat după schimbarea configurației, funcția e în starea InProgress, iar o invocare prea rapidă ar putea folosi încă setarea veche.
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 secondsStatus: 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
ErrorssauDurationa 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
Runtime.ImportModuleError: Error: Cannot find module 'app' Lambda nu găsește fișierul (sau pachetul) din care trebuie să încarce handler-ul: setarea Handler spune app.handler, dar în zip fișierul se numește index.mjs, sau codul importă un pachet care nu e în arhivă. Potrivește Handler cu numele fișierului (index.handler) ori pune dependențele în zip. 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. Invalid base64: "{"nume":"Ana"}" AWS CLI v2 tratează --payload ca date binare în base64, iar tu ai dat JSON simplu. Adaugă --cli-binary-format raw-in-base64-out la aws lambda invoke (sau setează-l o dată în ~/.aws/config) și payload-ul JSON merge direct. Î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.
