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

Runtime.HandlerNotFound: index.handler is undefined or not exported

Pe scurt

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

Greșit
BASH
const handler = async (event) => {
  return { mesaj: "Salut!" };
};
Corect
BASH
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

Greșit
BASH
// Handler: index.handler
export const main = async (event) => ({ ok: true });
Corect
BASH
// 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

Greșit
BASH
// index.mjs
module.exports.handler = async () => ({ ok: true });
Corect
BASH
// index.mjs
export const handler = async () => ({ ok: true });

Fișierele .mjs sunt module ES; module.exports nu există acolo.

Repară tu

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.

Alte forme ale mesajului

  • {"errorType":"Runtime.HandlerNotFound","errorMessage":"index.handler is undefined or not exported"}
  • Runtime.HandlerNotFound: index.main is undefined or not exported
  • Handler 'lambda_handler' missing on module 'lambda_function'

Cum o eviți pe viitor

  • Pornește fiecare funcție de la același schelet: index.mjs cu export const handler = async (event) => { ... }.
  • Testează local importul: node -e "import('./index.mjs').then(m => console.log(typeof m.handler))" trebuie să afișeze function.
  • 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

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