Tous les produits
Search
Centre de documentation

Function Compute:Gestion des erreurs

Dernière mise à jour :Sep 09, 2026

Function Compute intercepte les erreurs levées par votre fonction Node.js et renvoie une réponse structurée. Cette rubrique présente les deux catégories d'erreurs que peuvent produire les fonctions Node.js et explique comment interpréter les codes d'état HTTP du service.

Types d'erreurs

Exceptions interceptées

Lorsque votre fonction lève une exception, Function Compute l'intercepte et renvoie un objet JSON comportant trois champs :

Champ Description
errorMessage Le message d'erreur
errorType Le nom de la classe d'erreur JavaScript
stackTrace Un tableau de frames de pile d'exécution

Modules ECMAScript

La syntaxe des modules ECMAScript nécessite Node.js 18 ou une version ultérieure. L'exemple de code prend en charge le déploiement en un clic ( nodejs-fc-err-es ).
export const handler = async (event, context) => {
  throw new Error('oops');
};

Modules CommonJS

exports.handler = function(event, context, callback) {
  throw new Error('oops');
};

Exemple de réponse :

{
    "errorMessage": "oops",
    "errorType": "Error",
    "stackTrace": [
        "Error: oops",
        "    at handler (file:///code/index.mjs:2:9)",
        "    at module.exports (file:///var/fc/runtime/nodejs20/bootstrap.mjs:5655:14)",
        "    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)"
    ]
}

Arrêts anormaux

Si votre fonction appelle process.exit() pendant son exécution, le runtime ne peut pas capturer d'erreur structurée. Le service renvoie alors un message générique :

Modules ECMAScript

La syntaxe des modules ECMAScript nécessite Node.js 18 ou une version ultérieure.
export const handler = async (event, context) => {
  process.exit(1);
};

Modules CommonJS

exports.handler = function(event, context, callback) {
  process.exit(1);
};

Exemple de réponse :

{
    "errorMessage": "Process exited unexpectedly before completing request (duration: 12ms, maxMemoryUsage: 0MB)"
}

Codes d'état HTTP

Important

Une réponse 2xx ne garantit pas le succès de la fonction. Vérifiez la présence de l'en-tête de réponse X-Fc-Error-Type pour détecter les erreurs de fonction renvoyées avec un code d'état 2xx.

En cas d'échec d'un appel de fonction, Function Compute renvoie un code d'état HTTP, un corps de réponse et, pour les erreurs au niveau de la fonction, un en-tête de réponse X-Fc-Error-Type. Analysez ces signaux pour gérer les erreurs dans le code ou les transmettre aux utilisateurs finaux.

Code d'état Signification
2xx Function Compute a reçu la requête. Si la réponse inclut l'en-tête X-Fc-Error-Type, une erreur de fonction s'est produite, par exemple une exception non interceptée dans votre code.
4xx (à l'exception de 429) Le client qui a initié l'appel a envoyé une requête incorrecte.
429 La requête a été limitée (throttling).
5xx Une erreur interne s'est produite dans Function Compute, la configuration de la fonction est incorrecte ou un problème de ressource existe.

Pour plus d'informations sur les erreurs d'appel, consultez la rubrique Configurer un mécanisme de nouvelle tentative.

FAQ

require is not defined in ES module scope

Symptôme

Lorsque le fichier d'entrée d'une fonction Node.js est chargé en tant que module ES (l'extension du fichier est .mjs, ou package.json définit "type": "module") et que le code utilise require() pour charger des modules, l'appel renvoie le code d'état HTTP 200, les en-têtes de réponse incluent X-Fc-Error-Type: InvocationError et le corps de la réponse contient l'erreur suivante :

{
    "errorMessage": "require is not defined in ES module scope, you can use import instead",
    "errorType": "ReferenceError",
    "stackTrace": [
        "ReferenceError: require is not defined in ES module scope, you can use import instead",
        "    at file:///code/index.mjs:1:15",
        "    at ModuleJob.run (node:internal/modules/esm/module_job:218:25)"
    ]
}

Le contenu de l'erreur varie selon le type de fichier d'entrée et l'emplacement de require() :

  • Si le fichier d'entrée possède une extension .js et que package.json définit "type": "module", errorMessage inclut une ligne supplémentaire : This file is being treated as an ES module because it has a '.js' file extension and '/code/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.

  • Si require() est appelé à l'intérieur de la fonction handler plutôt qu'au niveau supérieur du module, errorMessage est require is not defined.

Cause

require() est la fonction de chargement du système de modules CommonJS et n'est pas disponible dans la portée des modules ES. Une fois qu'un fichier est identifié comme module ES, Node.js n'injecte pas les variables CommonJS telles que require, module et exports.

Solution

Choisissez l'une des méthodes suivantes en fonction de la structure de votre code :

  • Réécrivez require() sous forme d'instructions import de module ES. Pour charger un module dynamiquement, utilisez l'expression import().

  • Pour conserver la syntaxe require(), renommez l'extension du fichier d'entrée en .cjs. Aucune modification de la configuration du handler de fonction n'est requise.

L'exemple suivant illustre la réécriture en module ES (fichier d'entrée index.mjs) :

// Import a Node.js built-in module and a local ES module file
import { createHash } from 'node:crypto';
import { helper } from './utils.mjs';

export const handler = async (event, context) => {
  return createHash('sha256').update(helper()).digest('hex');
};

L'exemple suivant montre comment charger un module dynamiquement :

const crypto = await import('node:crypto');

L'exemple suivant illustre la syntaxe CommonJS (fichier d'entrée index.cjs) :

const crypto = require('crypto');

exports.handler = async (event, context) => {
  return crypto.createHash('sha256').digest('hex');
};
Remarque : Pour charger une dépendance tierce (telle que lodash ), exécutez d'abord npm install localement, puis empaquetez et déployez le répertoire node_modules conjointement avec votre code. Dans les modules ES, vous pouvez référencer une dépendance CommonJS en utilisant un import par défaut, par exemple, import _ from 'lodash'; .

Les modules ES sont pris en charge uniquement dans les runtimes Node.js 18 et versions ultérieures. Dans les runtimes Node.js 16 et versions antérieures, un fichier d'entrée .mjs n'est pas chargé et l'appel renvoie "errorMessage": "Module '/code/index.js' is missing." ainsi que "errorType": "FunctionUnhandledError: ImportModuleError".