Codes d'erreur

Chaque erreur rencontrée par l'utilisateur provenant de bext a un code stable suivant le modèle E_<AREA>_<WHAT>. Utilisez bext explain <code> pour obtenir de la prose complète, des exemples et les prochaines étapes à partir du terminal.

Référence rapide#

Configuration#

Code	Titre
`E_CONFIG_PARSE`	Le fichier de configuration n'a pas pu être analysé
`E_CONFIG_UNKNOWN_SECTION`	Section de niveau supérieur inconnue dans la configuration
`E_CONFIG_UNKNOWN_KEY`	Clé inconnue dans une section connue
`E_CONFIG_DEPRECATED_KEY`	Clé de configuration obsolète

Plugin#

Code	Titre
`E_PLUGIN_SCAN_BLOCKED`	Analyse du répertoire des plugins bloquée
`E_PLUGIN_LOAD_FAILED`	Le plugin n'a pas pu être chargé
`E_PLUGIN_MANIFEST_INVALID`	Le manifeste du plugin n’est pas valide

Construire#

Code	Titre
`E_BUILD_BUNDLE_FAILED`	La création du bundle SSR a échoué
`E_BUILD_TIMEOUT`	Le délai de construction a expiré

Rendre#

Code	Titre
`E_RENDER_SSR_PANIC`	Le rendu SSR paniqué
`E_RENDER_TIMEOUT`	Le rendu SSR a expiré
`E_RENDER_DEADLINE`	Délai de rendu dépassé (soft)

Cache#

Code	Titre
`E_CACHE_REDIS_DOWN`	Le backend du cache Redis est inaccessible
`E_CACHE_STAMPEDE`	Bousculade de cache détectée

TLS#

Code	Titre
`E_TLS_ACME_FAILED`	Échec de l'approvisionnement du certificat ACME
`E_TLS_CERT_EXPIRED`	Le certificat TLS a expiré

WAF#

Code	Titre
`E_WAF_RULE_BLOCKED`	Requête bloquée par la règle WAF
`E_WAF_RATE_LIMITED`	Demande à taux limité

Procuration#

Code	Titre
`E_PROXY_UPSTREAM_DOWN`	Le serveur en amont est inaccessible
`E_PROXY_TIMEOUT`	La requête en amont a expiré

Authentification#

Code	Titre
`E_AUTH_TOKEN_INVALID`	Le jeton d'authentification n'est pas valide
`E_AUTH_TOKEN_EXPIRED`	Le jeton d'authentification a expiré

Durée d'exécution#

Code	Titre
`E_RUNTIME_PORT_IN_USE`	Le port d'écoute est déjà utilisé
`E_RUNTIME_STARTUP_FAILED`	Le démarrage du serveur a échoué

Déployer et mettre à niveau#

Code	Titre
`E_DEPLOY_HEALTH_GATE_FAILED`	Échec du contrôle de santé post-déploiement
`E_UPGRADE_ROLLBACK`	Mise à niveau annulée

Secrets#

Code	Titre
`E_SECRETS_STORE_LOCKED`	Le magasin secret est verrouillé

Réseau#

Code	Titre
`E_NETWORK_DNS_FAILED`	La résolution DNS a échoué

Utilisation des codes d'erreur#

Depuis le terminal#

bash

bext explain E_CONFIG_PARSE

Le résultat comprend : une explication, des exemples concrets qui déclenchent l’erreur, les prochaines étapes numérotées et des références croisées aux codes associés.

En CI#

bash

bext explain E_CONFIG_PARSE --json

Renvoie un objet JSON avec les champs code, title, area, severity, explanation, examples, next_steps et see_also.

Liste de tous les codes#

bash

bext explain              # Human-readable table
bext explain --json       # Full JSON registry

Correspondance floue#

Si vous saisissez mal un code, bext suggère la correspondance la plus proche :

bash

bext explain E_CONFIG_PARS
# unknown error code `E_CONFIG_PARS`. Did you mean:
#   E_CONFIG_PARSE  Configuration file failed to parse

Comment les codes sont structurés#

code

E_CONFIG_PARSE
│ │      │
│ │      └── What happened (PARSE, UNKNOWN_SECTION, TIMEOUT, …)
│ └── Area of the system (CONFIG, PLUGIN, BUILD, RENDER, …)
└── Error prefix (always E_)

Chaque entrée dans le registre comprend :

Gravité — fatal, error, warning ou info
Explication — prose multi-phrases
Exemples — déclencheurs concrets
Étapes suivantes — numérotées, exploitables
Voir également — codes d'erreur associés

Conseil

Exécutez bext explain <code> --json dans CI pour obtenir une sortie lisible par machine, y compris next_steps sous forme de tableau. Ceci est utile pour automatiser le tri ou faire apparaître des conseils exploitables dans votre pipeline de déploiement.

En rapport#

Dépannage — commandes de diagnostic et de correction par symptôme
Enregistrement — les codes d'erreur apparaissent dans le flux de journaux level: "error"
Surveillance — règles d'alerte saisies sur http_requests_total{status=~"5.."}
Mises à niveau sans temps d'arrêt — E_UPGRADE_ROLLBACK et codes d'erreur de déploiement
Configuration : bext.config.toml — Les codes E_CONFIG_* font référence aux sections décrites ici