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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Handler-ul index.handler cere două lucruri: fișierul index din rădăcina arhivei și o funcție exportată cu numele handler. Runtime.HandlerNotFound înseamnă că primul pas a mers (fișierul există și s-a încărcat fără erori), dar al doilea nu: handler nu există printre exporturile modulului.
Cauze frecvente: ai scris const handler = async (event) => ... și ai uitat export; funcția are alt nume (main, lambdaHandler); ai amestecat sistemele de module (module.exports.handler = ... într-un fișier .mjs, care e modul ES, sau export const într-un .js tratat ca CommonJS); sau ai un export implicit (export default) în loc de unul cu nume.
În Node.js pe Lambda: într-un .mjs folosești export const handler = ..., într-un .js CommonJS folosești exports.handler = ....
De ce apare: cauzele frecvente
1Lipsește export
const handler = async (event) => {
return { mesaj: "Salut!" };
};export const handler = async (event) => {
return { mesaj: "Salut!" };
};Lambda vede doar ce exportă modulul; o constantă locală nu e vizibilă din afară.
2Funcția are alt nume decât în Handler
// Handler: index.handler
export const main = async (event) => ({ ok: true });// Handler: index.main
export const main = async (event) => ({ ok: true });Partea de după punct din Handler trebuie să fie exact numele exportului.
3Sintaxă CommonJS într-un fișier .mjs
// index.mjs
module.exports.handler = async () => ({ ok: true });// index.mjs
export const handler = async () => ({ ok: true });Fișierele .mjs sunt module ES; module.exports nu există acolo.
Repară eroarea, direct în pagină
Funcția Lambda salut (Handler index.handler) dă la invocare Runtime.HandlerNotFound: index.handler is undefined or not exported. Codul ei e în ~/salut/index.mjs. Repară codul (păstrează Handler-ul index.handler și mesajul), publică-l cu update-function-code și verifică: pentru {"nume":"Ion"} funcția trebuie să întoarcă Salut, Ion!.
Indiciu
În index.mjs funcția trebuie să fie exportată: export const handler = ... Apoi zip din folderul ~/salut și update-function-code.
Reparația
Exportă funcția:
cat > ~/salut/index.mjs <<'EOF'
export const handler = async (event) => {
return { mesaj: "Salut, " + (event.nume || "vizitatorule") + "!" };
};
EOFFă arhiva din folder și publică noul cod:
cd ~/salut && zip ../salut.zip index.mjs && cd ~
aws lambda update-function-code --function-name salut --zip-file fileb://salut.zip
aws lambda wait function-updated --function-name salutTestează:
aws lambda invoke --function-name salut --cli-binary-format raw-in-base64-out --payload '{"nume":"Ion"}' ~/r.json
cat ~/r.jsonDe ce merge
Fișierul index.mjs definea handler ca o constantă locală, fără export, așa că modulul se încărca, dar nu oferea nicio funcție cu acest nume. Cu export const handler, Lambda găsește exportul cerut de index.handler. Codul nou ajunge în funcție abia după update-function-code cu un zip proaspăt, iar wait function-updated așteaptă să fie activ.
Alte forme ale mesajului
{"errorType":"Runtime.HandlerNotFound","errorMessage":"index.handler is undefined or not exported"}Runtime.HandlerNotFound: index.main is undefined or not exportedHandler 'lambda_handler' missing on module 'lambda_function'
Cum o eviți pe viitor
- Pornește fiecare funcție de la același schelet:
index.mjscuexport const handler = async (event) => { ... }. - Testează local importul:
node -e "import('./index.mjs').then(m => console.log(typeof m.handler))"trebuie să afișezefunction. - Dacă schimbi numele funcției, schimbă și Handler-ul din configurație.
Întrebări frecvente
Pot folosi export default?
Nu direct cu Handler-ul index.handler. Lambda caută un export cu numele din Handler; export default creează exportul default. Folosește un export cu nume.
De ce codul nu dă eroare de sintaxă, dacă lipsește export?
Pentru că e cod valid: o funcție locală nefolosită. Eroarea apare abia când Lambda caută exportul la invocare.
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. 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ă. 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.
