---
title: "Dépannage"
description: "Que vérifier si une compilation échoue, si une modification n’est pas en ligne, si un domaine reste en attente ou si un appel est refusé."
canonical: "https://atelier201.com/docs/fr/platform/troubleshooting"
updated: "2026-11-06"
---

# Dépannage

## Une compilation a échoué

Ouvrez la compilation : `error` affiche un code et un message, et le journal indique la sortie du compilateur (les messages d’Astro). Causes fréquentes :

- Une valeur de contenu qui ne correspond pas à son schéma. Le journal indique le champ concerné. Corrigez le contenu, pas le schéma, sauf si vous vouliez ajouter un nouveau type de données.
- Une dépendance qui n’est pas disponible pour la compilation. Celle-ci s’exécute sans accès au réseau, avec les [packages disponibles sur Atelier201](/docs/platform/packages). Un projet qui ajoute un autre package ou une autre version est donc refusé. `dependencies_unavailable` indique ce cas, et le message précise le package.
- Un problème d’infrastructure. `build_infrastructure` signifie que le conteneur de compilation ou le stockage a échoué, et non que vos fichiers posent problème. Relancez la compilation.

Une compilation réussie de la même révision est réutilisée. Relancez donc la compilation après avoir corrigé le problème, et non avant.

## J’ai publié le site, mais les visiteurs voient encore l’ancienne version

La publication est répercutée sur toutes les adresses en une minute environ. Si l’ancienne version s’affiche toujours après ce délai, vérifiez que vous avez publié la compilation voulue : `atelier201 publish history` et le `published.build_id` du site indiquent la version en ligne. Une nouvelle publication ou un retour à une version précédente modifie le routage du site.

## La publication est refusée

| Message ou code                           | Cause                                                                                                                                                                        |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `409 conflict` après une vérification     | Quelqu’un a publié depuis votre vérification. Vérifiez à nouveau et envoyez le nouveau `expected_generation`.                                                                |
| `409 conflict` avec la liste des blocages | La compilation ne peut pas être mise en ligne. Chaque blocage indique la marche à suivre : consultez [Mise en ligne d’un site](/docs/platform/drafts-builds-and-publishing). |
| `403 insufficient_scope`                  | L’identifiant d’accès ne dispose pas de l’autorisation `sites:publish`. Demandez au propriétaire de publier ou reconnectez-vous avec cette autorisation.                     |
| `403 admin_required`                      | Seul un administrateur de l’espace de travail peut publier.                                                                                                                  |

## Une modification a été refusée en raison d’un conflit

Vous avez modifié un fichier qui a été changé par quelqu’un d’autre depuis que vous l’avez consulté. Les `details` de l’erreur contiennent la révision actuelle et les chemins concernés. Relisez ces fichiers et appliquez-y votre modification.

## Un domaine reste en attente

Un domaine passe de `pending_ownership` à `provisioning`, puis à `active` lorsque ses enregistrements sont en place. S’il reste à l’état `pending_ownership`, l’enregistrement TXT est manquant ou sa propagation n’est pas terminée. Comparez-le aux enregistrements affichés dans l’application, patientez, puis vérifiez de nouveau le domaine. Un conflit dont le message concerne l’offre signifie qu’il ne reste plus de domaine personnalisé disponible pour le site : supprimez-en un ou passez le site à une offre supérieure.

## Une limite de l’offre a été atteinte

La publication d’un brouillon est refusée avec `403 feature_not_available`. La création d’un brouillon au-delà de la limite de l’espace de travail et l’association d’un domaine à un brouillon sont refusées avec `409 conflict`. Chaque message indique la limite et renvoie vers la page permettant de l’augmenter (`action_url`). Passez le site à l’offre Site ou supprimez un brouillon, puis réessayez. Un agent ne doit pas réessayer en boucle ni modifier lui-même l’offre.

## Mon solde de crédits semble incorrect

Le solde correspond au total des crédits non expirés, moins ceux qui ont été utilisés. La page **Facturation** répertorie chaque attribution et sa date d’expiration. Seules les utilisations de l’IA consomment des crédits : l’assistant, ainsi que les images et les vidéos générées par l’IA.

## Je n’arrive pas à me connecter

Vérifiez l’adresse e-mail associée au compte. Un compte créé avec Google et un compte créé avec un mot de passe ne sont identiques que s’ils utilisent la même adresse.
