Runtime.UserCodeSyntaxError: SyntaxError: Unexpected token ';'
Codul funcției Lambda are o greșeală de sintaxă, așa că runtime-ul nu îl poate încărca: invocarea întoarce FunctionError: Unhandled, iar în răspuns apare Runtime.UserCodeSyntaxError. Rulează codul local (node --check index.mjs), repară sintaxa, apoi publică din nou cu update-function-code.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când Lambda pornește un mediu nou pentru funcție, încarcă fișierul din Handler. Dacă acesta nu se poate parsa (paranteză sau acoladă lipsă, punct și virgulă în mijlocul unui obiect, ghilimele neînchise), runtime-ul se oprește înainte să ajungă la handler și raportează Runtime.UserCodeSyntaxError.
Din CLI, aws lambda invoke reușește (cod 0, StatusCode: 200), dar răspunsul are "FunctionError": "Unhandled", iar fișierul de ieșire conține {"errorType":"Runtime.UserCodeSyntaxError","errorMessage":"SyntaxError: Unexpected token ';'"}. Mesajul SyntaxError e cel al lui Node.js și îți spune ce caracter nu se aștepta.
În logurile CloudWatch (aws logs tail /aws/lambda/<funcție>) vezi aceeași eroare, de obicei cu linia. Pentru Python, echivalentul este Runtime.UserCodeSyntaxError: Syntax error in module 'lambda_function'.
De ce apare: cauzele frecvente
1Obiect returnat neînchis corect
export const handler = async (event) => {
return { mesaj: "Comanda " + event.id + " a fost primită" ;
};export const handler = async (event) => {
return { mesaj: "Comanda " + event.id + " a fost primită" };
};Lipsea } care închide obiectul, așa că ; apărea în mijlocul lui. Cu acolada pusă, fișierul se parsează.
2Codul publicat nu a fost testat local
zip functie.zip index.mjs
aws lambda update-function-code --function-name comenzi --zip-file fileb://functie.zipnode --check index.mjs && zip functie.zip index.mjs
aws lambda update-function-code --function-name comenzi --zip-file fileb://functie.zipnode --check verifică sintaxa fără să ruleze codul. Cu &&, arhiva se face doar dacă verificarea trece.
Repară eroarea, direct în pagină
Funcția Lambda comenzi întoarce la invocare Runtime.UserCodeSyntaxError: SyntaxError: Unexpected token ';'. Codul ei e în ~/comenzi/index.mjs. Repară sintaxa (păstrează mesajul), publică noul cod cu update-function-code și verifică: pentru {"id": 42} funcția trebuie să întoarcă Comanda 42 a fost primită.
Indiciu
În return lipsește acolada care închide obiectul. După reparare: zip din ~/comenzi, update-function-code, wait function-updated.
Reparația
Închide obiectul din return:
cat > ~/comenzi/index.mjs <<'EOF'
export const handler = async (event) => {
return { mesaj: "Comanda " + event.id + " a fost primită" };
};
EOFPublică și testează:
cd ~/comenzi && zip ../comenzi.zip index.mjs && cd ~
aws lambda update-function-code --function-name comenzi --zip-file fileb://comenzi.zip
aws lambda wait function-updated --function-name comenzi
aws lambda invoke --function-name comenzi --cli-binary-format raw-in-base64-out --payload '{"id": 42}' ~/r.json
cat ~/r.jsonDe ce merge
Obiectul din return nu era închis, așa că Node.js găsea ; acolo unde aștepta } și nu putea încărca modulul. Cu acolada pusă, fișierul se parsează, iar handler-ul rulează. Codul nou ajunge în funcție abia după update-function-code cu o arhivă refăcută; wait function-updated așteaptă ca versiunea nouă să fie activă înainte de test.
Alte forme ale mesajului
{"errorType":"Runtime.UserCodeSyntaxError","errorMessage":"SyntaxError: Unexpected token ';'","trace":["Runtime.UserCodeSyntaxError: SyntaxError: Unexpected token ';'"]}Runtime.UserCodeSyntaxError: SyntaxError: Unexpected end of inputRuntime.UserCodeSyntaxError: SyntaxError: Cannot use import statement outside a moduleRuntime.UserCodeSyntaxError: Syntax error in module 'lambda_function': invalid syntax (lambda_function.py, line 3)
Cum o eviți pe viitor
- Verifică sintaxa local înainte de fiecare publicare (
node --check, un linter ca ESLint). - Ține codul funcției într-un editor cu evidențierea erorilor.
- Testează funcția după fiecare
update-function-codecu uninvokeși verificăFunctionErrordin răspuns. - Pentru
importîn Node.js, folosește fișiere.mjssau"type": "module"înpackage.json.
Întrebări frecvente
De ce aws lambda invoke se termină cu cod 0, deși funcția a picat?
Invocarea în sine a reușit: Lambda a primit cererea și a răspuns. Eroarea funcției apare în câmpul FunctionError și în fișierul de ieșire. În scripturi, verifică explicit FunctionError.
Cannot use import statement outside a module e tot o eroare de sintaxă?
Da, pentru Node.js: fișierul .js e tratat ca CommonJS, unde import nu e permis. Redenumește-l index.mjs (Handler-ul rămâne index.handler) sau adaugă "type": "module" în package.json.
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. 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. An error occurred (ResourceNotFoundException) when calling the FilterLogEvents operation: The specified log group does not exist. Grupul de loguri cerut nu există în regiunea curentă. La Lambda, /aws/lambda/<funcție> apare abia după prima invocare și doar dacă rolul funcției are drept să scrie loguri (politica AWSLambdaBasicExecutionRole). Verifică numele, regiunea și permisiunile rolului. Î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.
