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

Runtime.ImportModuleError: Error: Cannot find module 'app'

Pe scurt

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

Greșit
BASH
zip comenzi.zip index.mjs
aws lambda create-function ... --handler app.handler --zip-file fileb://comenzi.zip
Corect
BASH
aws lambda update-function-configuration --function-name comenzi --handler index.handler

Partea dinaintea punctului e numele fișierului din arhivă, fără extensie.

2Fișierul e într-un subfolder al arhivei

Greșit
BASH
zip -r comenzi.zip proiect/
# în arhivă: proiect/index.mjs
Corect
BASH
cd proiect && zip -r ../comenzi.zip .
# în arhivă: index.mjs

Lambda caută fișierul în rădăcina arhivei, nu într-un folder.

3Dependență npm lipsă

Greșit
BASH
import axios from "axios";
// zip conține doar index.mjs
Corect
BASH
npm install axios
zip -r comenzi.zip index.mjs node_modules package.json

Lambda are doar Node.js și SDK-ul AWS; restul pachetelor vin în zip sau într-un layer.

Repară tu

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.

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.mjs
  • Runtime.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ția export const handler, Handler index.handler.
  • Rulează unzip -l pe 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

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