No such export getSharedObject in resource es_extended : la correction

Vous obtenez 'No such export getSharedObject in resource es_extended' ? Cela signifie que es_extended n'est pas en cours d'exécution quand votre script le demande. Les causes, de l'ordre de démarrage à l'échec de la connexion à la base de données.

No such export getSharedObject in resource es_extended : la correction

L'erreur complète ressemble généralement à ceci, dans la console du serveur ou en F8 :

text
SCRIPT ERROR: @my_script/server/main.lua:1: No such export getSharedObject in resource es_extended

Le code est correct. exports['es_extended']:getSharedObject() est exactement comment ESX Legacy distribue son objet. Le problème, c'est quand il s'exécute : à ce moment-là, es_extended n'est pas là pour répondre.

1. es_extended démarre après votre script

C'est la cause neuf fois sur dix. FiveM démarre les ressources dans l'ordre de votre server.cfg, et un script qui demande ESX à sa première ligne doit avoir es_extended qui tourne déjà.

Un ordre sûr pour un serveur ESX :

cfg
# database and libraries first
ensure oxmysql
ensure ox_lib

# the framework
ensure es_extended
ensure [esx]

# everything else after
ensure [scripts]
ensure my_script

Attention aux catégories de dossiers comme [scripts] : ensure [scripts] démarre tout ce qui est dedans, donc si cette ligne arrive avant ensure es_extended, chaque script qu'elle contient démarre trop tôt.

Vous pouvez aussi faire en sorte que le script lui-même attende ESX, en déclarant la dépendance dans son fxmanifest.lua :

lua
dependency 'es_extended'

FiveM démarrera alors es_extended en premier, ou refusera de démarrer le script s'il le manque.

2. es_extended n'a pas pu démarrer

Si es_extended plante au démarrage, ses exports n'existent jamais. Remontez la console du serveur vers le haut et cherchez des lignes rouges de es_extended avant l'erreur de votre script. Les coupables habituels :

  • La base de données. oxmysql ne peut pas se connecter (un mauvais mot de passe, une base de données qui n'existe pas, MySQL qui ne tourne pas). Vérifiez mysql_connection_string dans votre server.cfg :
cfg
set mysql_connection_string "mysql://user:password@localhost/es_extended?charset=utf8mb4"
  • Une dépendance manquante. Les builds récents d'ESX Legacy ont besoin que oxmysql et ox_lib démarrent avant eux.
  • Des tables manquantes. Une installation toute neuve sans les SQL d'ESX importés va planter à la première requête.

Corrigez cette première erreur et l'erreur d'export disparaîtra avec elle.

3. Le dossier ne s'appelle pas es_extended

L'export existe dans une ressource nommée exactement es_extended. Ceux-ci le cassent :

  • le dossier a été renommé (es_extended-legacy, es_extended_main…) ;
  • il y a deux copies d'es_extended dans des dossiers différents, et la mauvaise démarre ;
  • sur un hôte Linux, le nom a des majuscules différentes (ES_Extended) : Linux est sensible à la casse, Windows ne l'est pas.

Cherchez dans votre dossier resources des fichiers fxmanifest.lua dans des dossiers appelés es_extended et gardez-en exactement un.

4. Vous avez redémarré es_extended pendant que le serveur tournait

restart es_extended depuis la console semble inoffensif, mais chaque script qui a déjà pris l'objet ESX garde l'ancien, et tout ce qui appelle l'export pendant le redémarrage obtient cette erreur. Après avoir touché es_extended, redémarrez l'ensemble du serveur, ou au moins redémarrez les scripts ESX après.

5. Le serveur n'est pas ESX du tout

Si votre serveur exécute QBCore ou QBox, il n'y a pas d'es_extended, et un script ESX-only échoue exactement comme ceci. Cherchez une option de framework dans la config du script, ou utilisez une version conçue pour votre framework. L'équivalent QBCore de cette erreur est traité dans attempt to index a nil value (global 'QBCore').

Vérification en dix secondes

Dans la console du serveur :

text
ensure es_extended

Si es_extended démarre proprement et que l'erreur persiste, c'est l'ordre de démarrage. S'il imprime des erreurs, corrigez-les d'abord. Puis :

text
restart my_script

Si le script démarre maintenant sans erreur, déplacez son ensure en dessous de es_extended dans server.cfg pour qu'il fonctionne aussi après un redémarrage.

Résumé

Cause Comment vous le remarquez Correction
Ordre de démarrage Fonctionne après restart my_script ensure es_extended au-dessus du script, ou dependency 'es_extended'
es_extended a planté Lignes rouges d'es_extended au-dessus de l'erreur Corrigez la base de données ou la dépendance manquante
Nom de dossier incorrect ensure es_extended dit qu'il ne le trouve pas Exactement un dossier appelé es_extended
Redémarrage en direct Erreurs juste après restart es_extended Redémarrez le serveur
Pas un serveur ESX Pas d'es_extended du tout Utilisez la version QBCore / QBox du script

Réponses rapides

Que signifie « No such export getSharedObject in resource es_extended » ?

Votre script a appelé exports['es_extended']:getSharedObject() alors que es_extended n'était pas en cours d'exécution : il n'avait pas encore démarré, il n'a pas pu démarrer ou il a un nom de dossier différent.

Comment faire démarrer es_extended avant mon script ?

Mettez ensure es_extended au-dessus du script dans server.cfg, après oxmysql et ox_lib. L'ajout de dependency 'es_extended' au fxmanifest du script permet aussi à FiveM de démarrer es_extended en premier.

Puis-je redémarrer es_extended pendant que le serveur tourne ?

Ce n'est pas une bonne idée : chaque ressource qui a pris l'objet ESX garde l'ancien. Redémarrez l'ensemble du serveur, ou redémarrez au moins les scripts ESX après es_extended.

Des scripts sans ce problème

Advanced BoostingDu boosting de véhicules piloté par tablette : contrats de classe D à S+, crews et file d’attente en direct.Voir le script →CCTV Security CamerasDes caméras à placer, une tablette multi-vues en direct et des photos imprimées comme preuves.Voir le script →Crypto MiningAchetez un entrepôt, montez vos rigs pièce par pièce et minez sur un marché qui bouge.Voir le script →

À lire aussi