An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: Could not unzip uploaded file. Please check your file, then try to upload again.
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ă
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.mjszip 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.zipLambda acceptă la --zip-file doar o arhivă. zip o creează din fișierul sursă.
2file:// în loc de fileb://
aws lambda update-function-code --function-name facturi --zip-file file://facturi.zipaws lambda update-function-code --function-name facturi --zip-file fileb://facturi.zipfile:// 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
zip -r facturi.zip facturi/
# arhiva conține facturi/index.mjscd facturi && zip ../facturi.zip index.mjs && cd ..
unzip -l facturi.zipDacă 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ă 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.
Reparația
Fă arhiva din interiorul folderului:
cd ~/facturi && zip ../facturi.zip index.mjs && cd ~
unzip -l ~/facturi.zipCreează funcția cu arhiva și testeaz-o:
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
aws lambda wait function-active-v2 --function-name facturi
aws lambda invoke --function-name facturi --cli-binary-format raw-in-base64-out --payload '{"total": 250}' ~/r.json
cat ~/r.jsonDe ce merge
Scriptul trimitea direct fișierul index.mjs, iar Lambda acceptă la --zip-file doar o arhivă zip. Arhiva făcută din interiorul folderului are index.mjs în rădăcină, exact unde îl caută Handler-ul index.handler. Trimisă cu fileb://, adică octet cu octet, arhiva se dezarhivează fără probleme, iar funcția se creează și răspunde cu mesajul facturii.
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 zipAn 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
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. Error parsing parameter '--policy-document': Unable to load paramfile file://politica.json: [Errno 2] No such file or directory: 'politica.json' AWS CLI nu găsește fișierul dat după file://, relativ la folderul în care ești. Verifică cu ls și pwd, apoi dă calea corectă (file://politici/politica.json sau o cale absolută); pentru fișiere binare, cum e arhiva unei funcții Lambda, folosește fileb://. Î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.
