Aller au contenu principal

Lancez votre serveur FiveM en quelques clics ! Hébergement optimisé, anti-DDoS inclus et support 24/7.

Découvrir nos offres FiveM

Dépannage de la base de données MySQL (FiveM)

Ce guide regroupe les causes les plus fréquentes d'une base de données qui ne se connecte pas, ou d'un import SQL qui échoue, sur un serveur FiveM. Pour la mise en place initiale, voir Créer une base de données et Lier la base de données MySQL à FiveM.

Avant de supprimer ou recréer une base

Supprimer une base de données efface toutes ses tables et ses données. Avant toute suppression ou recréation, exportez-la depuis phpMyAdmin (onglet Exporter, format SQL) et gardez le fichier .sql sur votre PC.

1. Utilisez la ligne de connexion pré-générée​

L'onglet Bases de données du panel affiche, pour chaque base, une chaîne de connexion prête à coller au format oxmysql (FiveM), mot de passe inclus. C'est la source la plus fiable : copiez-la telle quelle dans votre server.cfg plutôt que de recomposer la ligne à la main.

set mysql_connection_string "…ligne copiée depuis l'onglet Bases de données…"

Après chaque modification du server.cfg, faites un arrêt complet puis un démarrage du serveur.

2. Mot de passe avec des caractères spéciaux (erreur 1045)​

L'erreur 1045 (Access denied) signifie que le serveur MySQL refuse les identifiants. Si le mot de passe contient des caractères spéciaux (@, #, /, :, ?…), ils cassent la chaîne au format mysql://… s'ils ne sont pas encodés. Ne reconstituez pas la ligne à la main : utilisez la ligne copiée par le panel (Copier la chaîne de connexion, format oxmysql), ou cliquez sur Nouveau mot de passe dans l'onglet Bases de données pour obtenir un mot de passe sans caractère spécial, puis recopiez la nouvelle ligne dans le server.cfg.

Un ancien format clé=valeur fonctionne encore mais est déconseillé : préférez le format mysql://.

set mysql_connection_string "host=HOTE;port=3306;user=UTILISATEUR;password=MOTDEPASSE;database=BASE"

Dans tous les cas, l'hôte est celui affiché dans l'onglet Bases de données (jamais localhost ni 127.0.0.1 sur une offre serveur de jeu) et le port MySQL est 3306.

Vérifiez aussi que le nom de la base dans votre server.cfg est exactement celui du panel : une simple faute sur ce nom suffit à empêcher la connexion.

3. Le champ « Connection From » à la création​

À la création d'une base, laissez le champ Connection From vide (ou %). Une autre valeur limite les connexions à une seule adresse et votre serveur FiveM se fait refuser.

Si la base a été créée avec une mauvaise valeur, elle doit être recréée : exportez-la d'abord (voir l'encadré en haut de page), supprimez-la, recréez-la avec Connection From vide, réimportez votre export, puis mettez à jour la ligne de connexion (le mot de passe change).

4. Utilisez oxmysql, pas mysql-async​

mysql-async est déprécié depuis longtemps. Utilisez oxmysql : c'est la ressource attendue par les bases récentes (ESX, QBCore, ox_inventory…). Une erreur « dépendance oxmysql introuvable » signifie qu'oxmysql n'est pas installé (ou que son dossier est mal nommé) dans resources/. En cas d'erreur inexpliquée, commencez par mettre oxmysql à jour.

5. Import SQL : retirez CREATE DATABASE​

Un dump qui contient une ligne CREATE DATABASE … (souvent suivie de USE …) échoue à l'import : votre utilisateur n'a pas le droit de créer une base, et la base existe déjà côté panel. Supprimez ces lignes du fichier .sql, sélectionnez votre base dans phpMyAdmin, puis relancez l'import. Voir Importer et compresser un fichier SQL.

6. « ALL PRIVILEGES » n'est pas attribué​

Le droit ALL PRIVILEGES correspond à des droits d'administration du serveur de bases de données : il n'est pas attribué. Ce n'est pas nécessaire : à la création d'une base depuis le panel, votre utilisateur reçoit tous les droits utiles au fonctionnement d'un serveur FiveM (lecture, écriture, création et modification de tables…). Un script qui exige ALL PRIVILEGES ou GRANT doit être adapté.

7. Base hébergée sur MySQL-PROTECTED-01​

Les bases d'un serveur de jeu doivent se trouver sur un serveur MySQL-GAME (par exemple MySQL-GAME-01 ou MySQL-GAME-02). Si l'onglet Bases de données indique que votre base est sur MySQL-PROTECTED-01 et que la connexion échoue malgré une ligne correcte, recréez la base sur un serveur MySQL-GAME si le choix vous est proposé (après l'avoir exportée) ; sinon, ouvrez un ticket : l'équipe la replace pour vous.

Récapitulatif​

SymptômeCause probableCorrectif
Erreur 1045 / Access deniedMot de passe avec caractères spéciaux, nom de base erronéLigne copiée depuis le panel, nouveau mot de passe, vérifier le nom
ECONNREFUSED en boucleHôte ou port faux (ou localhost / 127.0.0.1) dans la chaîneLigne copiée depuis le panel, bouton Corriger de l'onglet FiveM : voir Lier MySQL
Connexion refusée malgré une ligne correcteChamp Connection From renseignéExporter, recréer la base avec le champ vide
Import qui échoue dès la première ligneCREATE DATABASE / USE dans le dumpRetirer ces lignes
« oxmysql introuvable »Ressource absente ou mal nomméeInstaller / mettre à jour oxmysql
Script qui exige ALL PRIVILEGESDroit non attribuéAdapter le script

Support​

Si l'erreur persiste, ouvrez un ticket avec le message d'erreur exact de la console (sans le mot de passe) et le nom de la base tel qu'il apparaît dans le panel.