# Résoudre les problèmes de bases de données

> Les symptômes fréquents lors de la création, de la connexion et de la suppression d'une base, leur cause et leur solution.

Cette page part de ce que vous voyez dans la console ou dans les logs de vos services. Pour chaque symptôme : la cause, la solution, et comment vérifier.

## Symptômes

- [La base reste en attente](#la-base-reste-en-attente)
- [La base reste en Échec](#la-base-reste-en-échec)
- [Une base managée reste longtemps en Provisionnement](#une-base-managée-reste-longtemps-en-provisionnement)
- [Action non autorisée ou bouton grisé](#action-non-autorisée-ou-bouton-grisé)
- [Toutes les bases de données sont instanciées](#toutes-les-bases-de-données-sont-instanciées)
- [La variable de connexion est absente du conteneur](#la-variable-de-connexion-est-absente-du-conteneur)
- [La santé de la base est Non sain](#la-santé-de-la-base-est-non-sain)
- [Impossible de supprimer la ressource](#impossible-de-supprimer-la-ressource)

## La base reste en attente

**Cause** : une nouvelle demande est prise en charge en 30 secondes au plus. Au-delà de quelques minutes, la demande n'a pas pu démarrer.

**Solution** :
1. Rafraîchissez la page **Databases** pour écarter un affichage périmé.
2. Si le statut ne bouge pas après 5 minutes, contactez le support avec l'**Instance ID** affiché sur la page de la base.

**Pour vérifier** : le statut passe à **Provisionnement**.

## La base reste en Échec

**Cause** : la création a échoué. En mode managé, la cause la plus fréquente est une valeur refusée par OVHcloud : une version écrite autrement que dans la liste (`7` au lieu de `7.0` pour MongoDB, `8.0` au lieu de `8` pour MySQL), une offre inconnue ou une région mal orthographiée. Wakastart réessaie automatiquement, mais une valeur refusée échouera à chaque essai.

**Solution** :
1. Ouvrez la page de la base et vérifiez **Version**, **Plan** et **Région** dans les **Propriétés**.
2. Si une valeur ne figure pas dans la [liste des versions et offres](/v1.0/bases-de-donnees/reference#versions-et-offres), [supprimez l'instance](/v1.0/bases-de-donnees/supprimer-une-base) puis [provisionnez-la à nouveau](/v1.0/bases-de-donnees/provisionner-une-base) avec une valeur acceptée.
3. Si les valeurs sont correctes, contactez le support avec l'**Instance ID**.

**Pour vérifier** : le statut passe à **Provisionnement**, puis **Prêt**.

## Une base managée reste longtemps en Provisionnement

**Cause** : OVHcloud met plusieurs minutes, parfois quelques dizaines, à livrer une base. Wakastart attend ensuite la création des deux comptes applicatifs.

**Solution** : attendez. Au-delà de 60 minutes, la création passe d'elle-même en **Échec** et le symptôme précédent s'applique.

## Action non autorisée ou bouton grisé

**Cause** : votre profil ne porte pas le droit nécessaire : « Provisionner une base de données » pour créer ou modifier les ressources, « Supprimer une base de données » pour supprimer. Dans un environnement de production, il faut aussi « Accès infrastructure en production ».

**Solution** : demandez à un administrateur de votre organisation de vous attribuer le profil Infra, ou un profil qui porte ces droits.

## Toutes les bases de données sont instanciées

**Cause** : chaque déclaration de l'application a déjà une instance dans cet environnement. Une seule instance par déclaration est possible.

**Solution** : cliquez sur **Voir les instances** pour ouvrir l'instance existante. Pour une seconde base, [déclarez-en une nouvelle](/v1.0/bases-de-donnees/declarer-une-base) avec un autre shortname.

## La variable de connexion est absente du conteneur

**Cause** : la liaison pointe vers une base qui n'était pas encore **Prête** au moment du déploiement. Une entrée qui ne peut pas être résolue est ignorée, sans erreur.

**Solution** :
1. Vérifiez que la base est **Prête** et que ses entrées apparaissent dans l'onglet **Configuration**, filtre **Base**.
2. Dans l'onglet **Configuration du service (N)**, vérifiez la liaison, puis cliquez sur **Enregistrer la configuration** pour redéployer le service.

**Pour vérifier** : votre code lit la variable au démarrage, et l'onglet **Logs** ne montre plus d'erreur de configuration.

## La santé de la base est Non sain

**Cause** : dans le cluster, le conteneur de la base n'est pas prêt ou redémarre en boucle, souvent faute de mémoire. En mode managé, la base ne répond pas sur son port.

**Solution** :
1. Survolez la pastille de santé pour lire le message détaillé, par exemple `OOMKilled` pour une mémoire épuisée.
2. Pour une base dans le cluster qui manque de mémoire, [augmentez ses ressources](/v1.0/bases-de-donnees/modifier-les-ressources).
3. Cliquez sur **Vérifier maintenant** pour mesurer à nouveau.

**Pour vérifier** : la santé revient à **Sain**.

## Impossible de supprimer la ressource

**Cause** : vous supprimez une déclaration alors qu'une instance existe encore dans un environnement, ou n'a pas fini sa suppression.

**Solution** : supprimez l'instance dans chaque environnement, attendez qu'elle disparaisse de l'onglet **Databases**, puis supprimez la déclaration.

## Toujours bloqué ?

Contactez le support Wakastart en indiquant :
- le nom de l'application et de l'environnement ;
- l'**Instance ID** de la base, affiché sur sa page ;
- le statut et la santé affichés, avec l'heure de l'observation ;
- le message exact de la console ou de vos logs.
