Dépannage

La plupart des erreurs d’un serveur FiveM tombent dans quatre familles : une ressource qui refuse de démarrer, une base de données injoignable, une clé de licence refusée, et des lenteurs ou des téléchargements ratés pendant la partie. Cette page range les messages par moment d’apparition et renvoie, pour chacun, vers une correction pas à pas tirée de ce que nous avons vu en production.

Mise à jour : 15 novembre 2026

Lire le bon message

Une erreur en cache souvent une autre. Quand une ressource ne démarre pas, celles qui en dépendent échouent à leur tour, et la dernière ligne rouge de la console n’est presque jamais la cause.

  • Côté serveur, remontez la console de txAdmin jusqu’à la première erreur après le démarrage, et lisez-la en entier : le nom de la ressource y figure.
  • Côté joueur, ouvrez la console F8, ou les fichiers du dossier logs de FiveM.app, qui gardent tout le chargement.
  • Notez le message mot pour mot avant de redémarrer : un redémarrage efface la console, et une recherche sur le texte exact donne de meilleurs résultats qu’un résumé.

Au démarrage du serveur

Could not find dependency
Une ressource en réclame une autre qui manque, qui porte un autre nom de dossier, ou qui exige une version plus récente de FXServer. Correction : Could not find dependency.
You lack the required entitlement
Une ressource protégée par l’escrow de Cfx.re n’appartient pas au compte de la clé du serveur, ou ses fichiers ont été modifiés. Correction : erreur d’escrow.
Clé de licence refusée
La ligne sv_licenseKey manque, contient une clé invalide, ou le serveur dépasse ce que la clé autorise. Correction : clé de licence sv_licenseKey.

Base de données

oxmysql ne se connecte pas
Base arrêtée, mauvais port, utilisateur refusé, base inexistante ou chaîne de connexion mal écrite : le message d’oxmysql dit laquelle. Correction : erreur de connexion oxmysql.

Une base qui répond lentement ne produit pas d’erreur rouge : elle se voit dans les avertissements de requêtes lentes d’oxmysql, puis dans les hitch warnings.

Pendant la partie

server thread hitch warning
Le thread principal du serveur a pris du retard : une boucle, une requête ou une sauvegarde l’a bloqué. Correction : server thread hitch warning.
Couldn’t load resource
Un joueur n’a pas pu télécharger ou ouvrir un fichier : cache abîmé, connexion coupée, ou fichier streamé trop lourd. Correction : Couldn’t load resource.

Avant de chercher plus loin

  • Changez une seule chose à la fois, puis redémarrez : deux corrections en même temps ne disent pas laquelle a marché.
  • Testez sur un serveur de test avec sa propre base de données, jamais directement sur le serveur ouvert.
  • Gardez des artifacts récents : beaucoup de ressources exigent une version minimale de FXServer, et un serveur trop ancien produit des erreurs qui ne disent pas leur nom.
  • Après une mise à jour qui casse, revenez à la version précédente d’abord, cherchez ensuite.

Pour repartir d’une installation propre, suivez créer un serveur FiveM RP, et le générateur de server.cfg pour un fichier de configuration commenté.

Questions fréquentes

Où voir les erreurs d’un serveur FiveM ?
Dans la console du serveur, que txAdmin affiche dans son interface web. Côté joueur, dans la console F8 du jeu et dans les fichiers du dossier logs de FiveM.app.
Pourquoi mon serveur FiveM affiche-t-il des dizaines d’erreurs d’un coup ?
Parce qu’une ressource qui ne démarre pas fait échouer toutes celles qui en dépendent. Corrigez la première erreur de la console : les suivantes disparaissent souvent avec elle.
Faut-il mettre à jour les artifacts quand une erreur apparaît ?
Seulement si la ressource demande une version plus récente, ou si l’erreur est connue pour être corrigée dans une version suivante. Sinon, une mise à jour ajoute une variable de plus au problème.

À lire ensuite