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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Setarea Handler a unei funcții Lambda are forma fisier.functie: index.handler înseamnă „încarcă fișierul index (index.mjs sau index.js) din rădăcina arhivei și apelează funcția exportată handler”. Runtime.ImportModuleError apare la încărcare, înainte să ruleze codul tău: runtime-ul nu a putut importa modulul.
Cannot find module 'app' înseamnă că Handler-ul e app.handler, dar în arhivă nu există app.mjs / app.js. Alte cauze frecvente: fișierul e într-un subfolder al zip-ului (ai arhivat folderul, nu conținutul lui, deci calea devine proiect/index.mjs), sau codul importă un pachet npm (Cannot find package 'axios') care nu a fost inclus în zip, nici într-un layer.
Verifică ce e în arhivă cu unzip -l functie.zip și Handler-ul cu aws lambda get-function-configuration --query Handler.
De ce apare: cauzele frecvente
1Handler-ul nu se potrivește cu fișierul
zip comenzi.zip index.mjs
aws lambda create-function ... --handler app.handler --zip-file fileb://comenzi.zipaws lambda update-function-configuration --function-name comenzi --handler index.handlerPartea dinaintea punctului e numele fișierului din arhivă, fără extensie.
2Fișierul e într-un subfolder al arhivei
zip -r comenzi.zip proiect/
# în arhivă: proiect/index.mjscd proiect && zip -r ../comenzi.zip .
# în arhivă: index.mjsLambda caută fișierul în rădăcina arhivei, nu într-un folder.
3Dependență npm lipsă
import axios from "axios";
// zip conține doar index.mjsnpm install axios
zip -r comenzi.zip index.mjs node_modules package.jsonLambda are doar Node.js și SDK-ul AWS; restul pachetelor vin în zip sau într-un layer.
Repară eroarea, direct în pagină
Funcția Lambda comenzi dă la fiecare invocare Runtime.ImportModuleError: Error: Cannot find module 'app'. Codul din arhivă este fișierul index.mjs, care exportă funcția handler. Repară configurația funcției (fără să schimbi codul), astfel încât aws lambda invoke --function-name comenzi --cli-binary-format raw-in-base64-out --payload '{"nume":"Ana"}' ~/r.json să întoarcă Salut, Ana!.
Indiciu
Handler-ul are forma fisier.functie; vezi-l cu aws lambda get-function-configuration --function-name comenzi --query Handler.
Reparația
Vezi Handler-ul actual și corectează-l:
aws lambda get-function-configuration --function-name comenzi --query Handler
aws lambda update-function-configuration --function-name comenzi --handler index.handler
aws lambda wait function-updated --function-name comenziInvocă funcția:
aws lambda invoke --function-name comenzi --cli-binary-format raw-in-base64-out --payload '{"nume":"Ana"}' ~/r.json
cat ~/r.jsonDe ce merge
Funcția fusese creată cu Handler-ul app.handler, deci runtime-ul căuta fișierul app.mjs, care nu există în arhivă. Cu --handler index.handler, Lambda încarcă index.mjs și apelează funcția exportată handler. Codul nu s-a schimbat: doar legătura dintre configurație și fișier. După wait function-updated, invocarea întoarce mesajul de salut.
Alte forme ale mesajului
{"errorType":"Runtime.ImportModuleError","errorMessage":"Error: Cannot find module 'app'\nRequire stack:\n- /var/runtime/index.mjs"}Runtime.ImportModuleError: Error: Cannot find package 'axios' imported from /var/task/index.mjsRuntime.ImportModuleError: Unable to import module 'lambda_function': No module named 'requests'
Cum o eviți pe viitor
- Păstrează convenția: fișierul
index.mjs, funcțiaexport const handler, Handlerindex.handler. - Rulează
unzip -lpe arhivă înainte de upload. - Construiește zip-ul din interiorul folderului proiectului, ca fișierele să fie în rădăcină.
- Folosește o unealtă de deploy (SAM, Serverless, CDK) care împachetează dependențele corect.
Întrebări frecvente
E aceeași eroare ca Runtime.HandlerNotFound?
Nu. ImportModuleError înseamnă că fișierul (modulul) nu a putut fi încărcat. HandlerNotFound înseamnă că fișierul s-a încărcat, dar nu exportă funcția cu numele din Handler.
Codul e bun, l-am testat local. De ce nu merge în Lambda?
Local ai node_modules și poate alt nume de fișier. Lambda vede doar ce e în zip; verifică arhiva și Handler-ul.
Erori înrudite
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. 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ă. An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: The role defined for the function cannot be assumed by Lambda. Rolul dat în --role nu există sau politica lui de încredere nu permite serviciului lambda.amazonaws.com să-l preia. Pune în trust policy "Principal": {"Service": "lambda.amazonaws.com"} (aws iam update-assume-role-policy) și creează funcția din nou. Î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.
