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

An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: Could not unzip uploaded file. Please check your file, then try to upload again.

Pe scurt

Lambda a primit la --zip-file ceva care nu e o arhivă zip validă: fișierul .mjs/.py direct, un zip stricat sau o arhivă trimisă cu file:// în loc de fileb://. Fă arhiva cu zip functie.zip index.mjs și trimite-o cu --zip-file fileb://functie.zip.

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

Ce înseamnă

Parametrul --zip-file așteaptă conținutul binar al unei arhive .zip cu codul funcției. Lambda încearcă s-o dezarhiveze; dacă nu poate, răspunde cu InvalidParameterValueException și Could not unzip uploaded file. Funcția nu e creată (sau, la update-function-code, codul vechi rămâne).

Trei cauze acoperă aproape toate cazurile: ai dat fișierul sursă direct (fileb://index.mjs), ai folosit file:// în loc de fileb:// (CLI-ul citește fișierul ca text și îl strică), sau arhiva e goală ori stricată (comanda zip a eșuat, iar fișierul a rămas de 0 octeți).

Verifică arhiva local cu unzip -l functie.zip: trebuie să vezi fișierul handler-ului (index.mjs) direct în rădăcina arhivei, nu într-un folder.

De ce apare: cauzele frecvente

1Fișierul sursă trimis direct, fără arhivă

Greșit
BASH
aws lambda create-function --function-name facturi --runtime nodejs22.x --handler index.handler \
  --role arn:aws:iam::123456789012:role/lambda-exec --zip-file fileb://index.mjs
Corect
BASH
zip facturi.zip index.mjs
aws lambda create-function --function-name facturi --runtime nodejs22.x --handler index.handler \
  --role arn:aws:iam::123456789012:role/lambda-exec --zip-file fileb://facturi.zip

Lambda acceptă la --zip-file doar o arhivă. zip o creează din fișierul sursă.

2file:// în loc de fileb://

Greșit
BASH
aws lambda update-function-code --function-name facturi --zip-file file://facturi.zip
Corect
BASH
aws lambda update-function-code --function-name facturi --zip-file fileb://facturi.zip

file:// citește fișierul ca text și îi schimbă octeții. fileb:// îl trimite neatins, cum trebuie pentru orice fișier binar.

3Handler-ul e într-un subfolder al arhivei

Greșit
BASH
zip -r facturi.zip facturi/
# arhiva conține facturi/index.mjs
Corect
BASH
cd facturi && zip ../facturi.zip index.mjs && cd ..
unzip -l facturi.zip

Dacă handler-ul nu e în rădăcina arhivei, dezarhivarea merge, dar apare altă eroare la invocare: Runtime.ImportModuleError sau HandlerNotFound. Arhivează din interiorul folderului.

Repară tu

Repară eroarea, direct în pagină

Vrei să creezi funcția Lambda facturi (nodejs22.x, Handler index.handler, rolul lambda-exec) din codul aflat în ~/facturi/index.mjs. Comanda din ~/creeaza-facturi.sh dă Could not unzip uploaded file. Fă arhiva corect, creează funcția și verifică: pentru {"total": 250} trebuie să întoarcă Factura de 250 lei a fost emisă.

Indiciu

cd ~/facturi && zip ../facturi.zip index.mjs, apoi --zip-file fileb://facturi.zip.

Alte forme ale mesajului

  • An error occurred (InvalidParameterValueException) when calling the UpdateFunctionCode operation: Could not unzip uploaded file. Please check your file, then try to upload again.
  • An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: Uploaded file must be a non-empty zip
  • An error occurred (InvalidParameterValueException) when calling the UpdateFunctionCode operation: Unzipped size must be smaller than 262144000 bytes

Cum o eviți pe viitor

  • Folosește mereu fileb:// la --zip-file.
  • Fă arhiva dintr-un script de build, din folderul funcției, și verific-o cu unzip -l înainte de publicare.
  • Nu pune în arhivă fișiere inutile (teste, .git); pentru dependențe mari folosește Lambda Layers.
  • Pentru proiecte reale, folosește SAM sau Serverless Framework, care fac arhiva corect.

Întrebări frecvente

Pot încărca codul fără zip?

Din CLI, nu: --zip-file cere o arhivă. Alternativele sunt arhiva într-un bucket S3 (--code S3Bucket=...,S3Key=...) sau o imagine de container. În consolă poți edita codul direct, dar consola tot o arhivă salvează.

De ce update-function-code a picat, dar funcția încă merge?

Pentru că actualizarea a fost refuzată în întregime: funcția a rămas cu codul vechi. Repară arhiva și rulează din nou comanda.

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.